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(57) Abstract 

A workflow management system which performs eight key functions: i) notifies the user that be or she has a step to begin or to 
complete (Names/Routings); ii) provides the user with the proper tools to complete a task (Transaction Manager); iii) provides the user with 
the proper information to complete a task (Workflow Server); iv) allows the user to see where a task fits in the overall process (Schedule); 
v) manages the proper reminders, alerts, and follow-ups to keep the process moving (Transaction Manager); vi) automates certain standard 
procedures: vii) integrates with the organization's existing business systems: and viii) provides simple application program interfaces that 
allow developers to develop new custom applications that are workflow-enabled (Workflow Updater). 
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METHOD AND APPARATUS FOR MANAGING BUSINESS PROCESSES 



BRIEF SUMMARY OF THE INVENTION 

Businesses are demanding new systems that directly 
support the management of business processes, systems 
that bring order and coordination to the flow of work. 
They are seeking to automate that part of office work 
that has been impervious to conventional data processing 
and information processing systems, which were not 
designed for business process management and are not 
well-suited to help with it . 

The present invention is a system for analyzing and 
structuring business processes that, when implemented in 
software, provides businesses with the tools they need to 
manage business processes efficiently and cost- 
effectively . 

The invention can be applied to all business 
processes from simple applications, such as intelligent 
forms routing, to sophisticated mission-critical 
enterprise-wide systems that integrate all marketing, 
production, and customer fulfillment processes. 

The resulting system enables users of the system to 
take coordinated action quickly and to manage processes 
painlessly. The results are increased productivity, 
reduced cycle time and hence, improved customer 
satisfaction. 

Workf low-enabled systems facilitate business 
processes. To do so, a workflow management system 
performs eight key functions: 

•Notifies the user that he or she has a step to 
begin or to complete. 

•Provides the user with the proper tools to 
complete a task. 
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•Provides the user with the proper information to 
complete a task. 

•Allows the user to see where a task fits in the 
overall process . 

•Manages the proper reminders/ alerts, and follow- 
ups to keep the process moving. 

•Automates certain standard procedures . 

•Integrates with the organization's existing 
business systems. 

•Provides simple application program interfaces 
(APIs) that allow developers to develop new custom 
applications that are workf low-enabled . 

The workflow system's architecture is designed to 
fit within a variety of computer systems, collecting 
around itself not only specific applications, but also 
system enhancements and utilities from users and third- 
party developers. In addition, the architecture is 
designed to allow for interoperability among different 
applications and across diverse platforms. 

A fundamental concept of a workflow system is that 
any business process can be interpreted as a sequence of 
basic transactions called workflows. Every workflow has 
a customer, a performer, and conditions of satisfaction. 
The customer and performer are roles that participants 
can take in workflows. In addition, each workflow can 
have observers. 

In a workflow, the customer is the person for the 
sake of whom the work is done, either because they made a 
request or accepted an offer. It is customers who are 
responsible for evaluating performed work and determining 
whether this work meets their conditions of satisfaction. 
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The performer is the person who is responsible for 
completing the work and for declaring to the customer 
when the work is done. 

Requests and Offers are the two basic types of 
workflows. There are other workflow types such as 
Question, Inform and Note that are simplified derivations 
of Request and Offer. The conditions of satisfaction 
• specify the work to be performed by the performer. In a 
request, the customer specifies the conditions of 
satisfaction, and in an offer the performer specifies 
them. (Then, of course, the two can enter into 
negotiation about the work to be done.) 

For example, given the sentence: 

"John asked Frank to prepare the report and deliver 

it by noon on Friday, " 
John is the customer for this workflow, Frank is the 
performer, and the conditions of satisfaction are 
"prepare the report and deliver it by noon on Friday." 
Further, because John asked for the report rather than 
Frank offering it, this workflow is of the type Request. 

Given the sentence: 

"John proposed to prepare the report and deliver it 

by noon on Friday for Frank, M 
John is the performer for this workflow, Frank is the 
customer, and the conditions of satisfaction are still 
"prepare the report and deliver it by noon on Friday." 
Further because John proposed the report rather than 
Frank asking for it, this workflow is of the type Offer. 

Observers of workflows take no direct action; they 
usually observe for management or training purposes. 

Business process maps display the workflows as 
loops, and display the relevant information about each 
workflow - the customer, the performer, the conditions of 
satisfaction and the cycle time. Figure 1 is a 
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* . 

business process map having a primary workflow 11, 
conditional workflows 13 and 15, a conditional link 17, 
parallel workflows 19 and 21, serial workflows 23 and 25. 
In a workflow system according to the present invention, 
associated with each workflow are various parameters such 
as roles, cycle time, conditions of satisfaction or 
associate semantics to the links that imply automated 
action or provide the framework for application building, 
all of which are necessary to create a useful business 
process representation. Each workflow has four phases. 
The first phase is called the proposal phase during which 
a request is made of the prospective performer by a 
customer or an offer to a customer is made by a 
prospective performer. The second phase is called the 
agreement phase during which the offer is accepted by the 
customer or the request is agreed to by the performer and 
conditions of satisfaction are identified. Of course, 
during the agreement phase the original conditions of 
satisfaction can be negotiated by the customer and 
performer until an agreement is reached. The third phase 
is called the performance phase during which the 
performer undertakes to meet the agreed to or accepted 
conditions of satisfaction. When the performer believes 
that the conditions of satisfaction have been met, the 
performer declares completion. The last phase is the 
satisfaction phase during which the customer determines 
whether or not the conditions of satisfaction have been 
met by the performer, and if so, declares satisfaction. 

In U.S. Serial No. 600,144 filed October 17, 1990 
and U.S. Serial No. 07/368,179 filed June 19, 1989, both 
owned by Action Technologies, Inc., the assignee of the 
present application, methods and systems for managing 
workflows, called conversations in the referenced 
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applications, are described. However, the teachings in 
the cited references are limited to single workflows with 
no capability for mapping business processes made up of a 
number of workflows linked together. In U.S. Serial No. 

filed January 15, 1993, a method and apparatus are 

disclosed for creating and modifying business process 
maps which is a desirable but not necessary component of 
the invented system. This component is referred to as 
the workflow analyst. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is pictorial representation of a business 
process, i.e., a set of linked workflows. 

Figure 2 is a block overview diagram of a complete 
workflow system. 

Figure 3 is pictorial representation showing the 
phases of a single workflow. 

Figure 4a is a transaction manager control flow 
when it detects the initiation of a new business process 
or workflow. 

Figure 4b is a transaction manager control flow 
when it detects a change in the transactions database 
that indicates that a user (or an agent) has taken an act 
in a workflow. 

Figure 4c is a transaction manager control flow 
when it processes the workflow events of a workflow. 



DETAILED DESCRIPTION OF THE INVENTION 
OVERVIEW 

The present invention is a method and apparatus 
which is used to enable application developers to 
generate workflow enabled applications that request 
services from the workflow server. These applications 
are used by users to act and participate in business 
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processes and enable managers to observe and query the 
status of workflows and business processes. 

Definitions 

In describing the invention, the following terms 
with their indicated definitions are used: 
Act 

Basic linguistic occurrence by which people 
intervene in moving a workflow towards completion. 
Agreement 

The outcome of the negotiation phase, in which two 
parties come to a common agreement of the 
conditions of satisfaction. 

Business Process 

A network of workflows linked together that 
represent the recurrent process by which an 
organization performs and completes work, delivers 
products and services and satisfies customers. 

Business Process Map 

This is a graphical representation of business 
process, which shows its workflows and their 
relationship . 

Primary workflow 

This is the first workflow which is initiated when 
a business process is initiated. Its condition of 
satisfaction represent the condition of 
satisfaction of the business process. 

Conditional Link 

A link that indicates that only one of a group of 
workflows will be triggered based on some 
condition . 

Conditions of Satisfaction 
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Conditions declared by or agreed to by a customer. 
The fulfillment of which is the purpose of a 
workflow. 
Customer 

The role in a workflow who makes a request or 
accepts and offer. 

Customer Satisfaction 

The objective of a workflow, the accomplishment of 
which is declared by the customer when the 
conditions of satisfaction in the workflow have 
been fulfilled. 

Cycle time 

A measure of the time from initiation to successful 
completion of a workflow phase, a complete workflow 
or a business process. 
Exception flow 

The path in the business process workflow map which 
is followed if a customer cancels or a performer 
revokes or declines. 

Link 

A defined dependency between two workflows and the 
mechanism by which dependencies between workflows 
is established. 

Loops (Workflow) 

A workflow is represented graphically by an 
elliptical loop with arrows shown in a clockwise 
direction wherein each quadrant of the ellipse 
signifies different phases of the workflow. 

Normal flow 

This is the path followed in a business process map 
when workflows complete with customer satisfaction. 
Observer 

A role in a workflow who cannot perform acts in the 
workflow, but is informed of acts in the workflow, 
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and has access to the information and data 
associated with the workflow. 

Offer 

The act by which the performer can initiate a 

i. 

workflow, specifying conditions of satisfaction 
that he is willing to satisfy for a customer. 

Organization roles 

Named positions in an organization who are 
authorized to make certain requests, agreements, 
take certain actions, set certain policies, and 
make certain decisions. The kind of roles will be 
accountant, office manager, etc. 

Performer 

One of the principal roles in a workflow: the role 
that commits to complete the conditions of 
satisfaction. 

Phase 

A characterization of the status of a workflow 
based on the acts that have happened and the acts 
that are permitted. Each workflow has four phases 
namely, the proposal phase the agreement phase, the 
performance phase and the satisfaction phase 
Request 

A customer does this act to initiate a workflow and 
declare conditions of satisfaction. 
Trigger 

An action in a workflow which causes an action in 
some other workflow. 
Triggered 

Action in a workflow based on certain 
conditions/status in some other workflow. 
Workflow 
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A structured set of acts between customers and 

performers organized to satisfy a customer's 

conditions of satisfaction. 
Workflow Activation 

A triggered action that enables the customer or 

performer of the workflow to take the initial act 

of the workflow. 
Workflow Initiation 

An act of request or offer initiates a workflow. 
Workflow Roles 

The association of participants in the workflows 

that take the acts in workflows; three roles are 

distinguished in workflows: customer, performer, 

and observer. 
Workflow Type 

This indicates whether the workflow is of request, 

offer or note type. 
Services Provided By A Workflow System 

The following describes the services provided by a 
workflow system. These . services are provided to 
applications via calls to the workflow server APIs. These 
workflow server APIs provide the main mechanism to 
interface and get access to the services provided by the 
server. In an alternate embodiment, these services can 
be provided via updates to the workflow server databases 
rather than via calls to the workflow server APIs. 
Transactions Services 

Transaction services are those related to 
initiating and acting in workflows by users and agents. 
These services are provided to workflow enabled 
applications via the transaction API. Alternatively, the 
services may be provided to workflow enabled applications 
through updates to the workflow transaction database. 
These services are also provided through the functions of 
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the workflow language specified in the definition of 
workflows . 

The services provided are as follows: 

a) Initiate a Workflow 

Through this function, an application requests the 
server to start a new workflow. For example, if a user 
fills an expense report form, when it is saved, the 
resulting record or document represents the initiation of 
a workflow, the application will use this service to 
start the workflow. 

For example, in a workflow enabled application in 
the Lotus Notes environment (available from Lotus 
Corporation), users initiate a new business process by 
composing a NOTES form in the transactions database. 
Users initiate workflows by editing and selecting options 
in forms. In other environments users fill in proper 
forms and the applications request the services via calls 
to the Transactions API. 

b) Act in a Workflow. 

Through this function, an application can take 
action on an existing workflow. For example, a manager's 
approval of an expense report indicates the fact the 
manager took an act in the workflow. 

c) Workflow status and available acts 
The workflow server updates and maintains the 

status of the workflow after each act is taken in a 
workflow. The server also updates the corresponding 
database records to reflect status and the available acts 
for the customer and performer such that users can see 
the workflow status and the available acts (given their 
role in the workflow) when they open the workflow 
transaction record of the transactions database or when 
they request such status from the server through one of 
the transactions API functions. 
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d) Bind and read process specific data (bound 
data) 

Through this function, an application binds 
application specific data to a workflow transaction. 
That is, this function allows applications to read and 
modify the process specific data (bound data) that the 
workflow server keeps in the workflow transaction 
document. The specification of the bound data (field 
names and their data types) are defined through 
definition services. This data is directly accessible to 
the application through transactions database forms. The 
server modifies the form specification to provide 
different display attributes of fields in forms depending 
on the status of a workflow. 

e) Workflows with pending actions 

Users can request to see a list of workflows with 
pending actions of the ongoing business process, given 
the role that the user has in the different workflows of 
the process. In the NOTES environment implementation, 
these lists are available through a set of views of the 
transaction database. 

f) Available Business Process 

These appear as a functional capability of a 
workflow enabled application. The workflow server reports 
the available business processes that a workflow enabled 
application can initiate. 
Definition Services 

Definition services are those related to defining 
the elements of a business process and its workflows and 
workflow links. 

a) Define a Business Process. 

Using the workflow application builder (or other 
design application that uses the workflow definitions API 
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which is the way the application builder interacts with 
the workflow server) , users can define the workflows and 
links that constitutes business process. In this 
connection, references herein to the workflow application 
builder should be understood as a reference to any design 
application which defines the workflows, links, 
conditional links and workflow language scripts that 
constitute a business process. The details for accessing 
the services provided by the server so that a suitable 
design application can be constructed should be apparent 
to persons skilled in the art based upon the descriptions 
contained herein, 

b) Define a workflow. 

Using the workflow application builder (or other 
design application) , users can define the structure of 
particular workflows that belong to the business process 
being defined through a set of structure definitions 
(specification of records of the workflow definitions 
database) and enable the application builder (or other 
design application) to create, modify and delete 
definition documents in the database. 

Using the workflow application builder (or other 
design application), users can specify the: 

•business processes 

•links and workflows and all their elements 
•conditional links between workflows 
•bound data 

•follow-up and reminder specification 
•automated action to be taken by the server 

Names and Routing Services 

Names and routing services are those related to 
defining organizational roles and identities. The names 
and routing services allow an authorized user to create, 
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modify and delete names and routing records in the 
names/routing database. These records contain the 
organizational roles and identities of the organization 
serviced by the server. They also contain the routing 
information for each identity that allows the server to 
queue notifications and reports for the proper STF 
* processor. These services are specified through the user 

interface of the application builder or other design 
application that uses the names/routings API of the 
workflow server. 

a) Define organization roles. 

Using the workflow application builder (or other 
design application) and a set of APIs from the workflow 
library, users can define roles used in the organization 
where the workflow system is implemented. 

b) Define identities. 

Using the workflow application builder (or other 
design application) and a set of workflow definitions 
APIs from the workflow library, users can define 
identities in the organization where the workflow system 
is implemented. 

STF Processing Services 

The STF processing services are provided by the 
server to STF processors (described below) through an STF 
queue database. The database contains records of pending 
notifications and reports to be given to specific users 
in applications that the STF processors service. STF 
processors process and delete these records once they are 
processed. 
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Configuration Services 

The configuration services are provided to the 
system administrator through a specific configuration 
database. Through a workflow server manager which is a 
user interface that uses the server administration API , 
the system administrator can define the network 
configuration of the system, the version of the servers, 
register STF processors, define the authorized users, 
specify the log database and the level of logging 
required. 

Scheduling Services 

The scheduling services allow an authorized user to 
create, modify and delete records of scheduled business 
processes. These records specify the date/time when the 
server must initiate a business process as well as the 
recurrence in which this initiation should happen. These 
services are specified through the user interface in the 
application builder. 

External Interfaces 

External interfaces provide services that are used 
by end-user applications, the workflow application 
builder, the workflow reporter and the STF processors. 
Some of these services, such as configuration services, 
are provided through specific user interfaces; others are 
provided by the workflow APIs. In an environment like 
NOTES (available from Lotus Corporation), where the 
client interfaces interact with the databases directly, 
client workf low-enabled applications access the databases 
directly to obtain workflow services. They do not use a 
programmatic API; instead they read and write workflow 
structures that are interpreted by the workflow server. 
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In other environments workf low-enabled applications 
access the workflow services through the workflow APIs. 
Network Architecture 

The workflow server component of a workflow system 
is designed to be installed at a single site, managing a 
single set of databases. It can manage one or many 
< business processes, and, as noted above, each business 

process can contain one or many workflows. 

The workflow server is configured through a 
configuration database. When the workflow server starts, 
it begins to monitor and update the workflow databases as 
appropriate. Each workflow server can monitor multiple 
definitions, transactions, or scheduling databases, as 
specified in the configuration database. 

In the NOTES environment distributed access to 
business process databases is achieved through the 
replication mechanisms of NOTES. 

The transactions database managed by the workflow 
server can be replicated through the standard mechanisms 
of NOTES. In this way, distributed access for viewing and 
changing business process status is achieved. 

A business process is designed in such a way that 
all the workflows that are part of the business process 
are stored and managed in a single NOTES (or other 
workflow enabled application) database. This database is 
then managed by a single workflow server for agent 
processing and workflow language interpretation. 

As a stand-alone server in the Microsoft Windows 
environment, a special version of the workflow server 
having a restricted functionality of services allows 
users of workf low-enabled applications to take action and 
move workflows to completion, but does not include the 
services of automated agents or of execution of workflow 
language scripts. 
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Components of a Workflow System 

A workflow system incorporates the following 
components which are shown in Figure 2, a workflow server 
and databases, application program interfaces (APIs) and 
workflow server manager. In addition, a complete 
workflow system of the type in which the present 
invention may be utilized includes an application 
builder, analyst, standard transaction format (STF) 
processors, workflow enabled applications and reporter 
components. The application builder, analyst, standard 
transaction format (STF) processors, workflow enabled 
applications and reporter components, while useful 
components of a complete workflow system, do not form 
part of the present invention and details concerning such 
components are set forth herein only as needed for an 
understanding of the invention. 

The following is a brief overview description of 
the workflow server, databases, APIs and workflow server 
manager which is followed by a detailed description of 
these components. Details concerning the remaining 
components are provided only as needed for a complete 
understanding of the invention. In the preferred 
embodiment as set forth below, the invented system is 
implemented using the Model, View, Class (MVC) paradigm 
of object oriented programming. 
Workflow Server 

The workflow server is the center of a workflow 
system. The workflow system concentrates workflow 
operations in the workflow server rather than in the end 
user applications. By using this client /server design, 
applications do not need to have the intelligence about 
workflows as part of their design. Application developers 
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can concentrate on their particular application 
development not having to worry about workflow logic and 
overhead because such functionality is handled at the 
server . 

Figure 2 shows the major components of the 
workflow server in relation to other components of a 
workflow system. These components are referred to as 
processes and modules. All work done by the server is 
performed by one of four processes which are referred to 
as the transaction manager, follow-up manager, date/time 
schedule manager and STF schedule manager. Processes are 
software components or tasks that are architected to run 
as separate entities from each other. The workflow server 
controls the four basic processes based upon workflow 
system server administration data in a configuration 
database in the following manner. First, it determines 
what STF processors need to run and spawns those 
processes. Second, it determines when to run the 
transaction manager and spawns that process. Third, it 
determines when to run the follow-up manager and spawns 
that process. 

These processes may be separate executables or 
simply separate tasks within the body of the workflow 
system server. 

Workflow server modules are software components 
that provide a specific type of functionality. Modules 
are used by the above processes and also among 
themselves . 

Organizationally the modules can be thought of as 
separate libraries. These modules are the workflow 
processor, workflow updater, the workflow instantiator, 
the workflow language interpreter, the workflow event 
handler, the agent actions manager, and the STF 
router/enqueuer manager. 
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Databases 

The workflow system utilizes the following 
databases : 

Definitions Database 

The definitions database contains records of the 
definitions of the organizations, business processes, 
workflows, roles, and acts. These records contain the 
instructions of what needs to be done in a workflow in a 
given instance. These records are used by the workflow 
updater and workflow processor to determine new workflow 
states and available actions. 

Transactions Database 

The transaction database contains records of the 
enactment of workflows. Each time a workflow is initiated 
or an action taken within a workflow, a corresponding 
record is made in the transactions database. These 
records include the workflow instances, the action 
transactions, the current incompletions, and the 
relationships between different workflows. 

Names /Routings Database 

The Names/Routings database contains records of the 
roles and identities of the organization where the 
workflow system is installed. It records the existing 
organizational roles, the current identities and the 
authorizations to act in one or more roles. 

Schedule Database 

The schedule database stores the date and time when 
a business process must be initiated. The date/time 
schedule manager reads this database. 

Admini st rat ion/ Configuration Database 
This database stores information needed by the 
workflow server to operate. 
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STF Queue Database 

This database stores the records of notifications 
to be sent to users that interact with the workflow 
system through an STF processor interface. 

Workflow APIs 

The workflow APIs provide a programming interface 
to access the services of the workflow server. Workflow 
enabled applications, STF processors (described below) 
and the application builder are all developed using these 
APIs. APIs of the invented system are as follows: 
transaction API, definitions API, reporter API, names and 
routings API, schedule API and administration API. 

Workflow Server Manager 

The workflow server manager is a component of the 
workflow system that provides a user interface for 
specific services of the workflow server such as: 

Server Management 

Authorization Maintenance 

Business Process Maintenance 

Workflow Maintenance 

STF Processor Maintenance 

Configuration 

Transaction Log Maintenance 

Business Process Scheduling and Organizational 
Calendar 

The WSM uses the workflow APIs to implement the 
functions and services it provides to users. Through the 
use of the WSM, a user selects the scheduling function 
which provides the user interface to specify the 
recurrent scheduling of business processes as well as the 
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specification of the organizational calendar as specified 
by the schedule manager. 
Workflow Application Builder 

The workflow application builder is a Graphical 
User Interface (GUI) application that allows a business 
process designer to specify the business process design 
with its network of workflows. The application builder, 
in turn, creates or edits the workflow definitions 
databases that define the business process and that will 
be used by the workflow server. The functions performed 
by the workflow application builder can alternatively be 
performed by a design application that uses the workflow 
definitions API of the workflow server. 
Workflow Analyst 

The workflow analyst is a GUI application that 
allows a business process analyst to specify the map of 
business processes with its network of workflows. Its 
output is readable by the application builder or 
equivalent which will update the definitions database of 
the server. Details concerning the workflow analyst may 

be found in co-pending U.S. Serial No. filed 

January 15, 1993. 
Workflow Reporter 

The workflow reporter is a GUI application that 
provides an interface to the transaction databases 
through the workflow reporter API of the system. It 
allows the observation of the status of current 
transactions as well as the history and performance of 
past transactions. Further details concerning the 
workflow reporter are not needed for a complete 
understanding of the present invention. Alternatively, 
such reports can be provided by an application that uses 
the workflow reporter API. 
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STF Processors 

An additional set of mechanisms for developing 
workf low-enabled applications are provided in a workflow 
system through the definition of a standard transaction 
format (STF) . This format defines the semantics for 
accessing the workflow services through different types 
of interfaces: messaging, databases and inter-process 
communication . 

For each one of these types of interfaces there is 
a syntactic definition that specifies the specific format 
for the representation of the workflow data and the 
process specific data in that medium. This syntax 
definition constitutes an STF API that a particular 
application will then use. 

The communication and interface between workflow- 
enabled applications that do not use the workflow APIs 
and the server is provided by STF processors. These STF 
processors map and translate between a workf low-enabled 
application's data format and the workflow APIs data 
elements . 

STF processors provide a layer for integration of 
many different protocols and technologies. STF processors 
can be constructed for any message transport environment 
protocol, database technology, and inter-process 
communication protocol. 

The interface from STF processors to the server is 
accomplished through the workflow APIs. From the point of 
view of workflow services, the STF processors appear to 
the server as additional applications. 

A standard transaction format (STF) processor is an 
application whose job is to interface external systems to 
the workflow system. There is one STF processor for each 
different type of system that interfaces to the workflow 
system. 
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WorJcf low-Enabled Applications 

A workflow-enabled application interfaces to the 
server via the workflow APIs or via direct access to the 
transactions database of the workflow server, or via the 
use of an STF processor which can use different 
interfacing mechanisms such as messaging, database or 
inter-process communication. 
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DESIGN AND IMPLEMENTATION DESCRIPTION 
A. WORKFLOW SERVER 

The workflow server is a set of processes, modules, 
databases and APIs as set forth above. The following is 
a description for implementing the processes, modules, 
databases and APIs of the workflow server. Also 
described is a workflow server manager which provides a 
user interface for specific services of the workflow 
server. 
Processes 

Transaction Manager (TM) 

The TM starts all the actions that must happen when 
there is a change in the transactions database. The TM 
is the driver for processing requests made by users 
through workf low-enabled applications. The transaction 
manager determines what changes in the transaction 
database have occurred. Records that have changed in the 
database are detected by the TM. The transaction manager 
manages a transaction queue and services queued 
transactions in FIFO order. Transactions may be entered 
directly by a user via forms available in workflow- 
enabled applications, which use the workflow transactions 
APIs to request the services of the workflow server, or 
they may be requested via an STF Processor. 

A workflow record that has changed, falls into one 
of several different categories. It may be: 

A request for initiation of a new business process; 

A request for initiation of. a new workflow within a 
business process; or 

A request for an act within a workflow. 

Each of the different types is dealt with 
differently. 

When there is a business process or workflow 
initiation 
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Figure 4a shows the control flow of the transaction 
manager when it detects the initiation of a new business 
process or workflow. In this case the transactions 
database will contain the record for the business process 
or the workflow being initiated. 

In Flow #1 the transaction manager detects the 
initiation of a business process or workflow in the 
transactions database. 

In Flow #2 the transaction manager calls the 
Instantiator Module, which will instantiate the workflow 
records based on the definition of the business process. 

In Flow #3 the instantiator reads the definition of 
the business process or workflow from the definitions 
database . 

In Flow #4 the Instantiator creates all the new 
transaction records for the corresponding workflow or the 
business process. 

Figure 4b shows the control flow of the 
transaction manager when it detects a change in the 
transactions database that indicates that a user (or an 
agent) has taken an act in a workflow. 

In Flow #1 the transaction manager detects the 
workflow act being taken in the transactions database. 

In Flow #2 the transaction manager calls the 
workflow updater to begin processing this newly updated 
transaction record. 

In Flow #3 the workflow processor calculates next 
available acts, new incompletions, etc. 

In Flow #4 the next available actions, 
incompletions, etc. are written to the transaction 
records . 

In Flow #5 the workflow updater checks the names 
database to see if one of the identities participating in 
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the workflow being processed needs to be notified via an 
STF processor. 

In Flow #6 if an identity has been identified in 
Flow #5 that needs to be notified via an STF processor, 
then the transaction is queued in the STF queue database. 

Figure 4c shows the control flow of the 
transaction manager when it processes the act and state 
events, which are also referred to herein as workflow 
events, of a workflow. In the definitions database, each 
workflow definition includes workflow language segments 
(scripts) that are associated with each act and stare of 
the workflow. 

In Flow #1 the transaction manager invokes the 
workflow event handler indicating the workflow, act and 
state that should be processed. 

In Flow #2 the workflow event handler reads the 
script for the act from the definitions database. 

In Flow #3 the workflow event handler invokes the 
workflow language interpreter to process the script. 

In Flow #4 If the script indicated that an action 
needs to be taken, the workflow language interpreter 
calls the agent actions manager to take the workflow act 
on behalf of the user. 

In Flow #5 the agent actions manager updates the 
transactions database to reflect that an act has been 
taken. 

The workflow event handler then repeats Flow #2, 
but in this case reads the script for the state of the 
workflow. The process continues to Flow #3 with respect 
to the state. 

The workflow event handler repeats Flow #2 and Flow 
#3 for the script that corresponds to the current state 
of the primary workflow of the business process. 
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In the preferred embodiment, the transaction 
manager is implemented as follows. The transaction 
manager identifies changes that have taken place in the 
workflow transaction database and invokes the proper 
server modules to provide the services that have been 
requested or that those changes represent . The 
transaction manager queues and services incoming 
transactions by instantiating a transaction-type-specific 
object . 

The date/time the transaction was entered is given 
along with its type and id. This date/time field is used 
to do FIFO (first in-firat out) queue retrievals. The 
earliest date/time will always be retrieved first. 

1TXTD is the id of a transaction in the Transaction 
Database. These ids are txtyp e dependent and can be used 
to access transactions directly from the database. 

The following is a description in pseudo-code for 
implementing the transaction manager process. This 
implementation is described in terms of a MAIN function 
or routine which includes a call to a loop (MainLoop) 
which executes continuously. 

MAIN 

The MAIN function connects to the Virtual 
Database (VDB) , performs the primary activity of[ the 
transaction manager and disconnects from the Virtual 
Database . 
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The primary activity of the transaction manager is 
checking the workflow transactions database for requests 
to process. It performs this primary activity by a call 
to the function MainLoop. 

In case of an error, the MAIN function performs a 
write to an error log, giving the error code and the 
message. The flow of the MAIN function is as follow: 

1. Connect to the Virtual Database. 

2. If connection is successful write a message to a log 
provided by the workflow server manager described 
below. 

3. If connection is not successful, write a message to 
the log and return. 

4. Call function MainLoop. 

5. Disconnect from the Virtual Database. 

6. If disconnection is successful write a message to the 
log 

7. If disconnection is not successful, write a message 
to the log and return . 

MainLoop 

This function performs the primary activity of the 
transaction manager. In an unconditional loop, it checks 
if any message has been sent from the workflow server 
manager (WSM) and processes it. It then performs the main 
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activity of checking for workflow requests and invokes 
either the workflow updater or the agent /act ion manager. 



1. Check for any message for the transaction manager 
from the WSM. To retrieve messages, the method 
bfnftgf Message of class MF.SfiAGEO is called. In case of 
any error, the error is written into the log file. 

2. Depending on the message, the message is processed 
differently, according to steps 3 and 4 below. 

3. If the message is to terminate the transaction 
manager, the function is terminated. 

4 . If the message is to indicate that the configuration 
has changed then do the following: 

5. The new configuration is retrieved using method 
bfnGetConf iglnfo of class CQNFIGINFQ. The new 
configuration is returned in a structure that 
contains all the configuration information. In case 
of error in retrieving the configuration information, 
the error is written in the log file. 



6. The configuration database specifies the polling 
interval and the log verbosity options. The polling 
interval is the time the transaction manager sleeps 
between processing cycles. The log verbosity option 
specifies the amount of information that gets written 
into the log file. The function AWSWriteToLog is 
used to log activities into the log file. 

7. Invoke workflow updater. 
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8. Invoke the agent actions manager. 

9. Sleep for a time interval of duration Polllnterval . 

10. Proceed to step 1. 

Follow Up Manager 

The follow-up manager runs periodically, scheduled 
per workflow server administration tables in the 
administration/configuration database. It can run 
asychronously to the transaction manager. It determines 
when notifications, either follow up or reminders, are to 
be sent and sends them. 

The follow-up manager detects transactions in which 
a participant has an overdue commitment and, depending on 
the workflow definition stored in the definitions 
database, will execute a script, send a mail message, or 
take other actions that are defined. The follow-up 
manager interacts with a Workflow Incompletion 
Transaction class which is part of the transaction 
database, which furnishes follow up and reminder times, 
in order to select workflows requiring notification. 

Follow up is specified in the workflow definition. 
This specification is done through the application 
builder or equivalent. For each workflow, a follow up 
specification can be made for each one of the roles of 
the workflow as follows: 

Specify when the follow-up will be done 
First and last valid times 
Recurrence interval 

Holidays on which not to follow-up (Optional) 
Days of week on which to follow-up (Optional) 
Time ranges in which to follow-up (Optional) 
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How many times to follow-up before stopping 
Specify incompletions to be followed up on 

Customer response due 

Performer response due 

Performer fulfillment due 
Specify the type of check 

Will be coming due (reminder) and how soon 

Is past due (follow-up) by how much 
Specify what to do for the follow-up 

In each workflow transaction, the current 
incompletions for each role are kept as indexed records . 
In addition to the date for the incompletion, the record 
will contain a field for the next date and time for 
follow up as well as the next date and time for reminder. 
The records will be indexed on these two date fields as 
well. The follow-up manager works off these incompletion 
records . 

The follow-up manager checks if the first follow-up 
or reminder date/time is due "now" and that "now" is not 
a restricted date/time according to the organizational 
calendar, and if so, retrieves the workflow language 
script and passes it to the Workflow Language Interpreter 
for processing. The follow-up manager deals appropriately 
with the case that the server has been down and processes 
all entries that are past due. 

The following is a description in pseudo-code for 
implementing the follow-up manager process. This 
implementation is described in terms of a MAIN function 
or routine which includes a call to a loop (MainLoop) 
which executes continuously. 

MAIN 
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The MAIN function connects to the Virtual 
Database (VDB) , performs the primary activity of the 
follow-up manager and then disconnects from the VDB. 

The primary activity of the follow-up manager is 
checking for overdue commitments and then sending 
reminders or follow-up messages. It performs this primary 
activity by a call to the function MainLoop. 

In case of an error, the MAIN function performs a 
write to an error log, giving the error code and the 
message. The flow of the MAIN function is as follow: 

1. Connect to the Virtual Database. 

2. If connection is successful write a message to the 
log . 

3. If connection is not successful, write a message to 
the log and return, 

4. Call function MainLoop. 

5. Disconnect from the Virtual Database. 

6. If disconnection is successful write a message to the 
log 

7. If disconnection is not successful, write a message 
to the log and return. 

MainLoop 
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This function performs the primary activity of the 
follow-up manager. In an unconditional loop, it checks if 
any message has been sent from the workflow server 
manager (WSM) using the workflow administration API, and 
processes it. It then checks for commitments due and 
sends follow-up and reminder messages if required. The 
flow of MainLoop is as follows: 

1. Check for any message for the follow up manager from 
the (WSM) . To retrieve messages, the method 
bfnGetMessage of class MESSAGEQ is called. In case of 
any error, the error is written into the log file. 

2. Depending on the message, the message is processed 
differently, according to steps 3 and 4 below. 

3. If the message is to terminate the follow-up manager, 
the function is terminated. 



4. If the message is to indicate that the configuration 
has changed, then do the following: 

5. The new configuration is retrieved using method 
bfnGetConf iglnfo of class CONFIGINFO. The new 
configuration is returned in a structure that 
contains all configuration information. In case of 
error in retrieving the configuration information, 
the error is written to the log file. 

6. The configuration database specifies the polling 
interval and the log verbosity options. The polling 
interval is the time the follow-up manager sleep 
between processing cycles. The log verbosity option 
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specifies the amount of information that gets written 
into the log file. 

7. The function FollowUp is called to perform the main 
activity of the follow-up manager. 

8. Sleep for a time interval of duration Polllntervai . 



9. Proceed to step 1. 



FollowUp 



The FollowUp function scans the Incompletions table 
of the transactions database and determines which 
incompletions are due for reminder or follow-up. The 
processing is done in two passes, one for reminders and 
the other for follow-ups . 

1. Set a flag to indicate if it is a reminder or follow- 
up pass . 

2. Get the current time. This time will be the basis for 
selecting incompletions which are due. If the 
incompletions are prior to the current date then the 
incompletion is processed. In case of error in 
getting the current time, log an error and return. 

3. Using methods of class TywFTNCOMPLETION from the 
transactions database, the incompletions due for 
processing are retrieved. Methods 

hfnflet.FirfitTnromplet.ion and bf nGetNeXt IftCQmplet. 100 
retrieve the incompletions that are due. 
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4. If an incompletion is due (reminder or follow-up), 
methods of class TW ™ rnMPT ' ETTQN are called to get 
the Business Process Id (IRPTid) , the Workflow Id 
(lHElid) and the Incompletion type(lncld). The 
following methods are used: 



Value 


Methods 


BPTid 


lfnGetBPTid 


WFTid 


IfnGetWFTid 


Incld 


fnGetlncId 



5. The workflow associated with the incompletion is 
retrieved from the VDB. An instance of the class 
tvwftnstance is created. The lB.PTid and the I WTT i d 
are passed as parameters. 

6. Depending on the incompletion, the workflow 
participant is determined. The logic for determining 
the workflow participant is as follows: 



Notification 
Type 


Incompletion 
Type 


Workflow 
Role 


Reminder 


Customer His Completion 


Performer 


Follow-uo 


rii.qt.omer His Resoonse 


Performer 


Follow-uo 


Customer His Completion 


Performer 


FoIIow-ud 


Performer His Response 


Customer 



7. Check if the Identity needs notification. The 

Identity attributes are retrieved from the VDB. These 
are stored in table wphftdknttty. If the Notification 
flag is set then the follow-up/reminder information 
is sent to the workflow participant. The notification 
information is retrieved using method frf nGetNot i f y . 



8. If notification is required, then retrieve the STF 
Processor Id, by using method ,1 f nfifit.STFPrgCld of 
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C l ass flfl pp identity . The notification is placed in the 
STF queue of this STF processor. 

9. The notification event is determined by the following 
table : 



Incompletion Type 


Event Tvpe 


Customer His 
Completion 


Performer Completion coming due 


Customer His Response 


Performer Response past due 


Customer His 
Completion 


Performer Completion past due 


Performer His 
Response 


Customer Response past due 



10. Get the time when the incompletion was due i.e. the 
Completion Time (this is not to be confused with the 
completion time of the workflow) . 

11. Get the reminder or follow-up time, i.e. the time 
this notification was due. (Note: It is important to 
distinguish between incompletion due time and 
reminder and follow-up due time) . 

12. Dispatch notification. The notification is placed 
in the STF Queue. Method hfnPutEvent of class 
tystfooeue places the notification. 

13. Determine when the next notification is to be sent. 
Get the workflow notification definition. This 
contains recurring information. The next follow-up 
time is determined and written to the incompletion 
table via method vf n*"^^ TownpTime . 

14. Get the next incompletion to be processed. If 
present, proceed to step 4. 
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15. Return, processing is complete. 

Date/Time Schedule Manager 

The date/time schedule manager detects events which 
are to be executed at a particular time. The scheduled 
events are kept in the schedule database. The events are 
placed in the database by the workflow server manager 
user interface via calls to the schedule API and are 
processed by the schedule manager. The scheduled events 
are kept in the database in chronologically increasing 
order . 

A schedule database entry specifies when the event 
will be done as well as the first and last valid times 
for the entry, indicating the first time it should happen 
and when it should stop happening. If the first and last 
valid times are the same, the schedule entry is executed 
once . 

A recurrence interval for a schedule entry is "how 
often" the schedule entry is executed. Recurrence 
intervals may be every X minutes, every hour, every day, 
every month, the third Thursday of every month, and so 
forth. 

An organizational calendar is connected to the 
schedule manager, so that entries may be tagged to not 
happen on specific days (such as weekends or holidays 
like Labor Day) . 

The schedule entry may be filtered to happen only 
on particular days of the week (such as Monday through 
Friday) . 

The schedule entry may be filtered to happen only 
during particular time intervals (such as any time 
between 8-12 or 1-5) 

The first thing that the schedule manager does in a 
cycle is to find events that are due now (or which are 
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past due) . This is done by finding those with a time-out 
time that is less than "now". 

For each of the found entries, the schedule manager 
then brings the time-out forward to "now", even if it is 
currently set in the past. This function should deal 
properly with the case when the server has been down. 

For each of the found entries, the schedule manager 
then passes the business process initiation script to the 
Workflow Language Interpreter for processing. 

After the schedule entry is processed, the schedule 
manager updates the schedule entry record for the next 
time out based on the parameter set for it. If the entry 
needs not be executed again, it is then removed from the 
schedule database . 

The following is a description in pseudo-code for 
implementing the schedule manager process. This 
implementation is described in terms of a MAIN function 
or routine which includes a call to a loop (MainLoop) 
which executes continuously. 

MAIN 

The MAIN function connects to the Virtual 
Database (VDB) , performs the primary activity of the 
Scheduler and disconnects from the Virtual Database. 

The primary activity of the schedule manager is to 
find business processes that are scheduled for initiation 
and start them. 

In case of an error the MAIN function performs a 
write to an error log, giving the error code and the 
message. The flow of the MAIN function is as follow: 
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1. Connect to the Virtual Database. 

2. If connection is successful write an message to the 
log . 

3. If connection is not successful, write a message to 
the log and return. 

4. Call function MainLoop. 

5. Disconnect from the Virtual Database. 

6. If disconnection is successful write an message to 
the log 

7. If disconnection is not successful, write a message 
to the log and return. 

MAINLOOP 

This function performs the primary activity of the 
schedule manager. In an unconditional loop, it checks if 
any message has been sent from the workflow server 
manager (WSM) using the workflow administration API, and 
processes it. It then performs the main activity of 
scheduling business processes at the scheduled time. 

1. Check for any message for the schedule manager from 
the WSM. To retrieve messages, the method 
hfnttfitMfissaae of class MESSAGEO is called. In case of 
any error, the error is written into the log file. 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



39 



PCT/US94/01287 



2. Depending on the message, the message is processed 
differently, according to steps 3 and 4 below. 

3. If the message is to terminate the schedule manager, 
the function is terminated. 

4. If the message is to indicate that the configuration 
has changed then do the following: 

5. The new configuration is retrieved using method 
bfnGetConfiglnfo of class configinfo . The new 
configuration is returned in a structure that 
contains all configuration information. In case of 
error in retrieving the configuration information, 
the error is written in the log file. 

6. The configuration constitutes the polling interval 
and the log verbosity options. The polling interval 
is the time the Scheduler sleeps between processing 
cycles. The log verbosity option specifies the amount 
of information that get written into the log file. 

7. The function Scheduler is called, this performs the 
main activity of the schedule manager. 

8. Sleep for a time interval of duration Polllnterval . 

9. Proceed to step 1. 
Scheduler 

The Scheduler function scans the scheduler table of the 
schedule database and determines which business processes 
are ready to be scheduled. 
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1. Get the current time. This time will the basis for 
selecting business processes which are due to be 
started. If the initiate time of the business process 
is after the current date then the business process 
is initiated. 

2. Using methods of class SCBPSCHEDULE the business 
processes due for initiating are retrieved. Methods 
bfnGetFirstlncompletion and bfnGetNext Incompletion 
retrieve the business processes that are due. 

3. Get the Business Process Definition Id (BPDid) . Use 
method lfnGetBPDid of class SCBPSCHEDULE. 

4. Get the Business Process Definition. Create an 
instance of class DFBP for definition id BPDid. 

5. Get the Business Process Name. Use method 
vfnGetBPName of class DFBP. 

6. Initiate the business process. Transactions API call 
AWSTINITBP is called. The Business Process Name is a 
parameter to this call. 

7. Determine the next time the Business Process needs to 
be scheduled. The Recurring Offset is retrieved using 
methods If nGetRecTime of class SCBPSCHEDULE. 

8. If the Recurring Offset is specified, the next 
initiate time is computed by adding the recurring 
offset to the current initiate time. 
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9. If the Recurring Offset is not specified, the 
scheduling entry is deleted from the table. 

10. Get next Business Process to be initiated. If 
present, proceed to step 3. 

11. Return, processing is complete. 
Modules 

Workflow Processor 

The workflow processor is the brain of the workflow 
system. The workflow processor is analogous to the 
central processor unit (CPU) in a computer. Both 
processors receive inputs in the form of events, and both 
carry out logic computations. The CPU embodies a logic 
processor, while the workflow processor embodies the 
logic of workflows with phases, cycle times, actions and 
roles. It contains the structures and Finite State 
Machines (FSMs) that specify the acts and actions that 
are available. This module is database independent, and 
provides an API through which the rest of the system 
interfaces with it . It is furnished with in-memory 
structures providing complete act/state data of a 
workflow, from which it derives updated status 
information returned via these structures. The workflow 
processor embodies the logic of workflows with phases, 
actions, roles and dates of completion and reply. 

The basic logic of the workflow server is very 
similar to that used by a human manager. It asks: 

• What actions have happened and not happened? 

• What data has changed? and 

• What amount of time has elapsed? 
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The workflow updater module of the workflow server 
asks the workflow processor: 

• What are the available acts for the customer 
and performer given the current state and the 
type of the workflow? 

• Given an act, what is the new state of- the 
workflow and what incompletions change? 

The workflow processor then answers with the state 
of the workflow and gives the answer to the workflow 
updater which updates databases, and changes the state of 
the workflow. 

These tasks would be impossibly complex if the 
number of states were large and the possible actions 
infinite. The present invention addresses this problem by 
defining a business model that intelligently defines a 
few conditions and actions as building blocks, but from 
which thousands of permutations can be constructed. 

A complete description of a suitable workflow 
processor which may be used in a workflow server may be 
found in U.S. Serial No. 600,144 filed October 17, 1990 
and U.S. Serial No. 07/368,179 filed June 19, 1989, both 
owned by Action Technologies, Inc., the assignee of the 
present application . 

Workflow Updater 

The workflow updater module processes requests made 
by users via API calls, changes to the transaction 
database or by agent actions. This module processes 
workflow transactions that have been modified, updating 
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them with the new workflow status information returned by 
the workflow processor. 

The workflow updater module updates the bound data 
in the business process, based on the data that was 
provided as part of the act that is being taken. If other 
scopes are defined for a workflow, then the bound data is 
updated in the scope of the workflow in which the act was 
taken. 

The workflow updater calls the workflow processor 
passing to it the workflow identification, the act being 
taken, the workflow role that is taking the act and the 
current state. The workflow processor returns to the 
workflow updater the new state of the workflow, the 
incompletion transitions (what incompletions need to be 
set, and which ones need to be removed) , the set of 
available acts for each one of the workflow roles and the 
times that can/must be specified by the users when taking 
each one of these available acts. 

The workflow updater maintains and updates the 
workflow transaction database. It uses the workflow 
processor to determine the status of workflows and the 
set of possible actions for each one of the roles. 

The workflow updater processes an act taken by a 
workflow participant i.e., the Customer or Performer. 
This act could have been taken through a call to the 
proper transactions API function, through a direct 
modification of the transactions database or by the agent 
actions manager upon request of the workflow language 
interpreter. When an act is taken, it is recorded in a 
act taken database record of the transactions database. 
The server sequentially processes all acts. The following 
is a description in pseudo-code for implementing the 
workflow updater module. 
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1. use ftw.qwritPToLoa method of the Translog class of the 
Administration database to log the act taking 
activity . 

2. Check whether there are acts to take by calling 
method hpnftPi-Fir^f TnOneue of class TxWFActS in the 

VDB. 

3. Check if the act is a valid act and the act is 
present in the list of available acts for an workflow 
participant by invoking method bf nCheckValidAct of 
class TwxFActs in the VDB. 

4. Find out the current state, WF type, WF role, and the 
Act by invoking respectively the methods 
fnftPtWFState . fnr^tWFTvDe. f nGftt WFRole , and fnGfff . Act 
of class TxWFActs in the VDB . 

5. Check with the workflow processor to determine if the 
act taken is consistent with the current state of the 
workflow and the role of the act taker (Customer 
/Performer) by invoking method bf nCherkValidAct of 
the class TxwFActs . 

6. Determine the new state of the workflow by calling 
the workflow processor. 

7. Compute the new set of incomplet ions by by calling 
the workflow processor. 

8. Compute the new set of acts and the date prompts for 
the customer and performer using function 
AWSTAvaj l ahl ftArt.s of the workflow processor. If any 
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* . 

acts are disabled then those are removed form this 
new set of acts using the method hf nlsD isabled of 
Class DFWFD i sab 1 edAct s of the VDB . 



9. Invoke the workflow event handler to interpret the 
scripts associated with the act, state, and the 
primary workflow. 

10. Send notifications the workflow participants 
informing the completion of the act by invoking the 
STF Router/Enqueuer . 



Classes and the methods invoked by the workflow updater 
module : 



Methods 


Class 


Action 


bfnCheckValidActs 


TxWFActS 


check if act is in 
Available Acts 
Table 


IfnGetCompletionTime 


TxWFInstance 


From VDB retrieve 
the Completion 
time 


lfnGetlncompletionTime 


TxWFActs 


From VDB retrieve 
the Incompletion 
Time 


AWSTAvailableActs 




compute available 
acts for both 
customer and 
performer . 



Workflow Inst ant iat or 



The workflow instantiator module is called by the 
transaction manager when it detects a request to initiate 
an instance of a business process or a workflow. The 
workflow instantiator instantiates business process and 
workflow records into the transactions database. This 
module creates workflow transaction records as specified 
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in business process definitions whenever a workflow is 
initiated. 

If the transaction manager detects a change in the 
transactions database that indicates a request for 
initiation of a new business process, the instantiator 
reads the business process definition and creates the 
transaction records for the business process and for the 
primary workflow of the business process according to the 
definition . 

If the transaction manager detects a change in the 
transactions database that indicates a request for 
initiation of a new workflow, the instantiator reads the 
workflow definition and creates the transaction record 
for the workflow according to the definition. 

The instantiator also performs the role to identity 
mapping so that the roles that are specified in the 
workflow definition get mapped to the proper identities 
in the transaction record of the workflow. 

The following is a description of the steps for 
implementing the workflow instantiator module. 

The instantiator creates an instance of a business 
process. It makes a copy of the definition. 

1. Check the length of the Business Process Name 
f szBPName ) is within limits. If beyond limits, return 

error. 

2. Validate the Instantiator Identity. Check if the name 
length is within limits. 

3. Check if Instantiator Identity is a valid user and 
registered. Method TnginrftAnthnri z at ion from class 
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AuthMaint. is used to determine if the user is valid and 
registered. This function accesses the Names /Rout ings 
database for validation, it calls the constructor of 

class lrenFTDENTTTY. 

4. Check if the Instantiator Identity is authorized to 
instantiate business processes. It checks the authorities 
table in the names/routings database to check if this 
identity is authorized to instantiate business processes. 
The authorization method In guireA nthnrization from class 
AuthMaint is called to determine the authorization. 

5. If the Customer name is specified, check if the name 
length is within limits. 

6. It the Customer name is specified, check that this 
name is valid and registered, method in quireAuthorization 
from class AuthMaint is used to determine if the user is 
valid and registered. This function accesses the 

Names /Rout ings database for validation, it calls the 
constructor of class NRDFIDENTITY . 

7. If the Performer name is specified, check if the name 
length is within limits. 

8. If the Performer name is specified, check that this 
name is valid and registered. Method TnguireAuthorizat ion 
from class AuthMaint is used to determine if the user is 
valid and registered. This function accesses the 
Names/Routing databases for validation, it calls the 
constructor of class NRDFIDENTITY. 

9. If the Completion date is specified, check if the date 
string length is within limits. 
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10. If the Completion date is specif ied r convert the date 
string to long format. 

11. If the Reply date, is specified, check if the date 
string length is within limits. 

12. If the Reply date is specified, convert the date 
string to long format. 

13. If the Initiate date is specified, check if the date 
string length is within limits. 

14 . If the Initiate date is specified, convert the date 
string to long format . 

15. If Completion and Reply dates are specified, the 
Reply date should be before the Completion date. 

16. If the Initiate date, if specified, it should be the 
earliest of all specified dates. 

17. Create an instance of this business process. The 
constructor for class txrp instance is called for this 

purpose . 

18. The central workflow instance is created. The 
constructor for class txwf instance is called for this 
purpose . 

19. Check for each organization role to identity any 
mapping which is specified at the time of initiation 
which overrides the mapping specified in the definition 
of the workflow, that the organization role and identity 
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do exist. To verify that the organization role is 
present, the constructor for class NRDFQRC;rot,e is called. 

To verify that the identity is present, the constructor 
for class nrhf identity is called. 

20. Store the organization role in classes txbpasstgn and 
txwf ASSIGN from the transaction database classes to 
identity overrides. The constructors are called for these 
two classes . 

21. Return status. 

Workflow Language Interpreter 

Workflow definitions are stored in the definitions 
database. Included in these workflow definitions are 
conditions under which workflows become active and 
inactive, and the conditions under which the workflow 
server should take specified actions. These conditions 
and instructions are expressed in the workflow language. 

The workflow language interpreter interprets 
workflow language scripts. These scripts or workflow 
language segments contain workflow commands, such as the 
initiation or taking an act in a workflow. These scripts 
are part of the business process definition. These 
scripts are automatically generated by the application 
builder or equivalent design application. 

The following is a description of the steps and 
syntax for implementing the workflow language interpreter 
module . 

The workflow language interpreter interprets both 
user defined and system generated scripts, and performs 
the corresponding function defined in the script. The 
user can perform the following functions on a workflow. 
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The workflow language interpreter interprets user-defined 
as well as system generated scripts, and performs tests, 
functions, and assignments as presented in either kind of 
script. The syntax and capability of the Act ionWorkf low 
scripting language are the same for the two kinds of 
scripts and is described as follows: 

Language Syntax 

A statement of the language is either an If 
Statement, an Action Statement or an Assignment 
Statement . 

An If Statement is either: 

If <boolean expression> statement 
1 . . . statement n endif 

or 

If <boolean expression> statement 
1 . . . statement s else statement s+1 . . . statement 

n endif 

where <boolean expression> is: 

TRUE 
FALSE 

<boolean expression> AND <boolean 

expression> 

<boolean expression> OR <boolean 

expression> 
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term> 



<bound data name> OPERATION <numeric 

IS INSTATE (workflow name, state name) 
ISNOTINSTATE (workflow name, state name) 

where OPERATION is 

equal to 
not equal to 
greater than 

greater than or equal to 
less than 

less than or equal to 



An Action Statement is either: 

INITIATE workflow name, 
ACTIVATE workflow name, or 
ACT workflow name, act name 

An Assignment Statement is either: 



<bound data name> 



<bound data name> 



or 



<bound data name> - <numeric term> 



2 . Capability 



The above-described syntax enables a script writer 
to start workflows, to act in workflows, to change bound 
data associated with a workflow, to test bound data 
associated with a workflow and conditional upon the 



SUBSTITUTE SHEET (RULE 26) 



52 

WO 94/18620 PCT/US94/01287 

results follow one or another distinctly different course 
of action. 

The workflow language interpreter can be divided 
into the following functional modules: 

1. The Lexical Analyzer which defines the Workflow 
Language grammar. 

2. The Parser which parses the workflow scripts and 
invokes the corresponding semantic routines associated 
with the commands in the script . 

The main implementation details are as follows: 

1. The workflow event manager calls the workflow 
language interpreter and passes to it the Business 
Process Transaction ID, the Workflow Transaction ID, and 
the Script Type to be executed. 

2 . Using this information the workflow language 
interpreter retrieves the appropriate workflow script 
from the definitions database using method 
bfnGetScriptName of the class DFWFActState . 

3. For the command Instantiate, the instantiator is 
invoked. 

4. For the command Activate, the workflow updater is 
invoked 

5. For the command TakeAnAct, the workflow updater is 
invoked . 

6. For external functions, the workflow language 
interpreter invokes the external function passing the 
specified parameters. 
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Workflow Event Handler 

The workflow event handler is called by the 
transaction manager to process the actions associated to 
acts and states in the workflow definition which are 
specified for a given workflow when an action is taken or 
a state reached in the workflow. It accomplishes this by 
reading the business process definition and by reading 
the workflow status information of the workflow 
transaction . 

The workflow event handler also looks in the 
definitions database for the workflow language scripts 
associated with acts and states of the workflow. The 
workflow event handler retrieves the language script 
corresponding to the act that was taken and passes the 
script to the workflow language interpreter for 
processing. The workflow event handler retrieves the 
language script corresponding to the state of the 
workflow and passes the script to the workflow language 
interpreter for processing. Then the workflow event 
handler retrieves the appropriate scripts associated with 
the states of the connecting workflows and passes them to 
the workflow language interpreter. Finally the workflow 
event handler retrieves the language script for the 
primary workflow of the business process for the current 
state of that workflow and passes that script to the 
workflow language interpreter for processing. 

The following is a description of the steps for 
implementing the workflow event handler module. 
The workflow event handler invokes the method 
AWSScriptToExecute of the workflow language interpreter 
to execute the following scripts associated with a 
workflow : 
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1. The system generated act script 

2 . The user generated act script 

3. The system generated state script 

4. The user generated state script 

5. The system generated state script of all the 
connected workflows 

6. The user generated state script of all the connected 
workflows 

7. The system generated state script of the primary 
workflow 

8. The user generated state script of the primary 
workflow 

To implement steps 7 and 8, the method 
bfnlsCentralWF of class obTxWF INSTANCE is used to 
determine the Current WF is the primary workflow. Method 
obWFInstance is used to obtain the primary workflow. 

Agent Actions Manager 

The agent actions manager module executes the 
commands specified in a script. These include Initiate, 
Act, Follow-up as well as external functions. In this 
form the agent action manager is taking workflow acts by 
an "agent" on behalf of some role in the workflow. The 
commands that the "agents" execute are specified through 
the workflow language. 
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The following is a description of the steps for 
implementing the agent actions manager module. 

The agent actions manager is invoked by the 
workflow language interpreter when it finds a workflow 
action or external function to be performed in a workflow 
language script. If the workflow needs to be instantiated 
the instantiation is done by the workflow instantiator 
module. After instantiation a flag is set to indicate if 
activation or initiation is required. The agent action 
manager scans for all workflows which have this flag set 
and processes them. The process is described below. 

1. Log the activity using the method AWSWriteToLog . 

2. Obtain the current date and time. 

3. Get the next workflow to act on by using method 
TxWF INSTANCE of class TXWF INSTANCE, which is the act 
to take queue . 

4. If the workflow to be processed is the primary 
workflow then change the Business Process status to 
"IN_PROGRESS" . The methods to use are bf nlsCent. ralWF 
and bFnSetBPStatus. 

5. If the Customer, Performer and Observer (s) are not 
specified, then pick up defaults and assign all the 
workflow participants . The methods to use are 
IfnGetCustld, IfnGctPerf Id, 1 fnPutCustlri and 
lfnPutPerf Id. 

6. Specify the default Reply and Completion time using 
methods lfnGetReplayDaf.e and 1 f nGet-.Complet j onTime of 
class TxWF instance . If these times not present, 
obtain them through the definition defaults by using 
methods fafnGetCycleTimes of class DFWFCYCLETTMES in 

the VDB. Assign the default using the methods 
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hfnPnf.RppI yDate and hf pPutComplet ionTime of class 
TxWFTNSTANCE. 

7. Set up environment for first act to be taken. The act 
is dependent on the workflow type, request act in a 
workflow of type request and offer act in a workflow 
of type offer. 

8. Make an entry in the Available Acts Table using 
method bfnPutAct of the class obAvlActs. 

9. Take the first act if the workflow is to be 
Initiated. The act to be taken is placed in the act 
to process queue using method obTxWFActs of class 
TXWDACTS. Log the message using AWSLogMessage . 



10. The flag is reset to indicate that the processing 
is complete using method bf nResetlnstantiate of class 
obTxWFInstance . 



Methods and Modules invoked by Agent Actions Manager 
Module 



Methods 


Class 


Action 


lfnGetBPTid 


TxBP INSTANCE 


get the BP 
Transaction Id 


IfnGetWFTid 


TxWF INSTANCE 


get the WF 
Transaction Id 


bfnSetBPStatus 


TxBP INSTANCE 


set the status of 
BP instance 


lfnGetPerf Id 




get the performer 
Id 


lfnGetCustld 


TxWFNSTANCE 


cret the customer Id 


lfnGetCompletionTime 


TxWFNSTANCE 


get cycle time of 
the WF 


TxWFActs 




queue the act to be 
taken 
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STF Router /Enqueuer 

The STF Router/Enqueuer module is called by the 
workflow updater to determine if the workflow currently 
being processed has a participant who must be notified in 
this workflow via an STF Processor. The router queues 
such transactions in the STF queue database for the 
appropriate STF processor to process. 

The following is a description of the steps for 
implementing the STF router/enqueuer module. 

1. The STF router/enqueuer first retrieves the BP and WF 
definition given the current WF transaction instance 
by using the methods TXBP INSTANCE and obTxWFInstance 
of classes txbp instance and TXWF INSTANCE . 

2. Using the BP and WF Ids, the follow-up definition is 
retrieved from the definitions database using method 
DFWFollowUp of class DFWFFOLLQWUP . If no 
notification required, just return. 

3. Get the notification status by using method 
NRDfldentity of class NRDFTDENTITY . If there is no 

need to do notification, just return. This is 
achieved through the method hf n ft fit Not, if y of class 
NRDfldentity in the vdb. 

4. Get the STFProcId using method If nGetSTFPrQCld of 
class NRDfldentity. 

5. Write the Notification event in the STF queue 
database using method bfnPutEvent of class 
TxSTFOUEUE . The date and time is computed. 

Databases 
Virtual Database 
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The present invention utilizes a Virtual Database 
for implementing the databases used by the system. The 
Virtual Database (VDB) is designed to be a collection of 
classes and methods. "Virtual" because it is DBMS 
independent. The VDB contains all the necessary storage 
structures to support the operations of the Workflow 
Server. More importantly, it defines a collection of 
methods for the manipulation of these structures and 
their instances. The basic domain as well as the classes 
for workflow definitions, transactions, schedules, names 
and routing, STF queue and server administration and 
configuration are described below. These classes define 
the attributes and methods for the data manipulation 
supporting the Workflow Server. 

Basic Domain Classes 
The basic domain classes used in the server are listed 
here in alphabetic order. 

act 

act = { request, offer, decline-request, agree, declare- 
complete, declare-satis faction, cancel, revoke, 
accept-off er, decline-offer, counter-offer, accept - 
counter-offer, decline-counter-offer, count er-with- 
request, declare-dissatis faction, question, answer, 
inform, open-speculation, continue-speculation, 
revise-offer, revise-request, follow-up, note, 
comment, initiate, activate, cancel-new-request, 
revoke-new-promise, revoke-new-offer, commit~to- 
commit, interim-report, delegate, accept- 
delegation, decline-delegation, cancel-delegation, 
declare-complete-delegation, declare-satis faction- 
delegation, revoke-delegation, start-with-promise, 
accept-starting-promise, decline-starting-promise } 
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bpstatus 

bpstatus = { inprogress, completed, aborted, suspended } 

configuration 

configuration « { optionl, option2, ...} 

date time 

Time is a built-in domain in the Virtual Database. Its 
counter part in the underlying DBMS will provide the 
actual implementation . 

datetimeof f set 

Datetimeof f set is a unit of time. Its value can range 
from seconds, days, weeks, and months, but is expressed 
in seconds . 

in completion 

The various incompletions that need to be managed for the 
Customer and Performer in terms of Completions and 
Responses . 

incompletion = { CMC, CMR, CHC, CHR, PMC, PMR, PEC, PER } 

1st letter - C for Customer, P for Performer 

2nd letter - M for My, H for His 

3rd letter - C for Completion, R for Response 

notification 

This domain class specifies the events which require 
notification, 

notification = {PerformerResponsePastDue, 

PerformerCompletionPastDue, PerformerCompletionComingDue, 
CustomerResponsePastDue, Act } 

ob jecttype 

objecttype = { BP, WF, STFProcessor } 
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privileges 

privileges = { create, delete, modify, activate, 
schedule, assign privileges } 

state 

state = { request/offer, inactive, initial (after 
activation) agreement, completion, satisfaction, counter, 
decline, cancel revoke } 

string 

String is defined to be a character string with varying 
length. 



txstatus 

Status of the a transaction. 

txstatus = { pending, inprogress, complete } 



txtype 

List of various types of transactions processed by the 
server . 

txtype = { initbp, initwf, actinwf, bindappdata, 
getbounddata, getbounddatafieldattributes, status, 
availableacts, querywf, availablebp, acthistory, 
not ificationst ring ) 

wf role 

wfrole = { customer, performer, observer } 



wf type 

wftype = { reguest, offer, note } 



Definitions Database 
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DFBP 

This class contains the Business Process (BP) definitions 
which includes information such as the BP Name f the BP 
Version, The person (ID) who created the BP, The date 
when this information was last modified, The Server ID 
which is the Home Server of this BP and the name of the 
file which contains the mapping of this BP. 



Attributes 



IDEN 


lBPDid 


CHAR 


szBPName fBPNAME LEN] 


INT 


iVersion 


IDEN 


lBPAdmin 


LONG 


lLastModDate 


IDEN 


lHomeServerld 


CHAR 


SzBPmao f BLOBNAME LEN 1 
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Methods 



DFBP 

■ 


The Constructor of this Class: 
Depending on its first 
parameter it returns the first 
record from the table which 
matches the predicate, or 
creates a new Business Process 
in the Table with the given 
parameters, or creates a new 
version of an existing 
Business Process with the 
aiven parameters 


BOOL bfnDelete 


Deletes the record whose 
parameters matches the DFBP 
class attributes 


IDEN lfnGetBPDid 


Returns the BPDid of the BP in 
context to the Class 
attributes 


INT ifnGetVersion 


Returns the BP Version of the 
BP in context to the Class 
attributes 


IDEN lfnGetLastModDate 


Returns the Date when the BP 
Definition was last modified 
in context to the Class 
attributes 


BOOL bfnPutBPMap 


Creates/Appends to the Map 
file of the BP, the data in 
memory . 


BOOL bfnGetBPMap 


Retrieves the specified number 
of bvtes from the Map file. 


BOOL bfnNumListBP 


Returns the Number of BPs for 
which there exists a 
Transaction in the Tx Database 


BOOL bfnListBP 


Returns the List of BPs for 
which there exists a 
Transaction in the Tx Database 


BOOL bfnListDFBP 


Returns the list of all BPs 
defined in the Definitions 
Database . 


VOID vfnGetBPName 


Returns the BP Name of the BP 
in context to the Class 
attributes 



DFWF 

This class contains the Workflow definitions which 
include information such as the WF Name, the WFDid, the 
BPDid to which this workflow belongs, the type of 
workflow (primary or non primary) , the default IDs of the 
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customer and performer for this WF, the Repeat IF acin 
factor in case of repetitive WFs, the form names and the 
Conditions of satisfaction 



Attributes 



IDEN 


lBPDid 


IDEN 


lWFDid 


BOOL 


bCentralWFFlacr 


CHAR 


szWFName fWFNAME LENT 


WFTYPE 


WFType 


IDEN 


lCusOraRole 


IDEN 


IPerOraRole 


INT 


iRepeatFieldld 


INT 


iRepeatFieldFactor 


CHAR 


szCustFormName fFORMNAME LEN1 


CHAR 


szPerFormName [FORMNAME LEN] 


CHAR 


szObsFormName [FORMNAME LEN] 


CHAR 


szlnitFormName [FORMNAME LEN] 


CHAR 


szCOS[COS LEN] 
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Methods 



DFWF 


Constructor of this class 
which depending on its first 
parameter it returns the 
first record from the table 
which matches the predicate 
or creates a new worxiiow 
Definition in the Table with 
the aiven Darameters 


BOOL bfnModify 


Modifies the Workflow 
Definition of an existing 
workflow (in context or tne 
Class attributes) in the 
Table with the given 
Darameters 


BOOL bfnModifyForms 


Modifies the form names of 
an existing workflow (in 
context of the Class 
attributes) in the Table with 
the aiven form names 


BOOL bfnPutCOS 


Appends/ Creates the 
conditions or satisfactions 
of an existing workflow (in 
context of the Class 
attributes ) in une laDie witn 
the aiven COS 


BOOL bfnGetCOS 


Retrieves the Conditions of 
Satisfaction or an existing 
workflow (in context of the 
Class attributes) 


IDEN lfnGetWFDid 


Returns tne wruici or an 
existing workflow (in context 
of the Class attributes) 


WFTYPE fnGetWFType 


Returns the WF type of an 
existing workflow (in context 
of the Class attributes) 


IDEN lfnGetCustOrgRole 


Returns the customer ID of an 
existing workflow (in context 
of the Class attributes) 


IDEN lfnGetPerfOrgRole 


Returns the Performer ID of 
an existing workflow (in 
context of the Class 
attributes) 



DFWFOBS 

This class contains 'the workflow observer 
definitions which includes information such as the WFDid, 
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the BPDid to which this workflow belongs, the Observer ID 
for the WF . 



Attributes 



IDEN 


lBPDid 


IDEN 


lWFDid 


IDEN 


lObserver 



Methods 



DFWFOBS 


The constructor for this 
Class, which depending on 

i f e f i ref Tia rflfflPt" T" "it** 
ilo i_ x x o L- pai auic l. ci ~l u * 

creates a new Workflow 
Observer Definition in the 
Table with the given 
parameters, or returns the 
first record from the table 
which matches the predicate 


BOOL bfnDelete 


Deletes the record whose 
parameters matches the 
DFWFOBS class attributes 


BOOL bfnGetWFObsList 


Returns the List of 
Observers defined for the 
workflow (in context of the 
Class Attributes) 


INT nfnGetWFObsCount 


Returns the Number of 
Observers defined for the 
workflow (in context of the 
Class Attributes) 



DFBP CONTAINER 

This class contains the Business Process Container 
Information (the Container ID for a particular BP) . 

Attributes : 



IDEN 


lBPDid 


IDEN 


IContainerld 
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DFBP CONTAINER 


Creates a new Container 
Definition for a BP with the 
n t \rpn narampt*^r^ (in context 
of the Class Attributes) It 
also inserts a record in 
another table (DFCONTAINER) 
with the Container ID and 
the number of fields 


IDEN lfnGetContainerld 


Returns the Container ID (in 
context of the Class 
Attributes) 



DFFIELD 

This class contains the Container Field Information 
which includes the Container ID to which the field 
belongs, the Field ID ,the data type of the field, its 
maximum length, its attributes, and its initial Value. 

Attributes 



IDEN 


IContainerld 


IDEN 


lFieldld 


INT 


iDataTvpe 


INT 


iMaxLen 


ATTRIBUTES 


Attr 


CHAR 


szlnitVal FINIT VAL LENl 


Methods : 



DFFIELD 



Creates a new Container 
field record with the 
given parameters. It 
also inserts a record in 
another table 
(DFBDFIELDLIST) with the 
BPDid, the Field ID and 
the field name. 



DFLINK 

' This class contains the Workflow Link Information 
which includes the BPDid to which this LINK belongs, the 
ID of the workflow from which the LINK starts, whether 
the link starts from an act or from a state, the 
act/state IDs from which the Link starts and at which 
link ends, and the Destination State ID. 
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IDEN 


lBPDid 


IDEN 


lFromWFid 


BOOL 


bFromActOrState 


IDEN 


lFromAcf-OrStateld 


IDEN 


lToWFid 


BOOL 


bToActOrState 


STATE 


ToStatP 



Metnoas : _ . 

DFLINK 


The Constructor for this 
Class that creates a new 
Link record with the ^ 
given parameters. Using 
WFName WFID is first got 
from DFWF 


BOOL bfnGetWFLinks 


Returns all the links to 
a aiven WFID 



DFBFASSIGN 

This class contains all the Identity to 
Organization role mappings at the Business process level. 



Attril 


butes : 


IDEN 


lBPDid 


IDEN 


lldentitvld 


IDEN 


lOraRole 



Metnoas . 

DFBP ASSIGN 


The constructor of this 
class that depending on 
its first parameters 
creates a new BP 
assignment in a given 
BPDid with the given 
parameters or returns the 
first record from the 
table which matches the 
predicate 


IDEN lfnGetldentity 


Returns the Identity ID 
(in context of the Class 
attributes) 



DFWFASSIGN 

This class contains all the Identity to 
Organization role mappings at the Workflow level. 
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Attributes : 



IDEN 


lBPDid 


IDEN 


IWFDid 


IDEN 


lldentitvld 


IDEN 


lOroRole 


WFROLE 


WFRole 



Methods : 



DFWF ASSIGN 


The constructor of this 
class that depending on 
its first parameter it 
creates a new workflow 
assignment in a given 
WFDid and BPDid with the 
given parameters or 
returns the first record 
from the table which 
matches the predicate 


IDEN lfnGetldentity 


Returns the Identity ID 
(in context of the Class 
attributes) 



DFBPNOTIFICATION 

This class contains all notification string 
information at BP level. 



IDEN 


lBPDid 


NOTIFICATION 


NEvent 


CHAR 


szNstrina fNSTRING LENT 



Methods : 



DFBPNOTIFICATION 


This is the constructor for 
this class that creates a 
new BP notification for a 
qiven BPDid 


BOOL bfnGetEventString 


Returns the BP notification 
strina of an event in a BP 



DFWFNOTIFICATION 

This class contains all notification string 
information at workflow level 
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Attributes 



IDEN 


lBPDid 


IDEN 


lWFDid 


NOTIFICATION 


NEvent 


CHAR 


szNstrinafNSTRING LENT 



Methods : 



DFWFNOTIFICATION 


This is the constructor 
for this class that 
creates a new workflow 
notification for a given 
WFDid and BPDid 


BOOL bfnGetEventString 


Returns the workflow 
notification string of an 
event at workflow level. 



DFWFCYCLETIMES 

This class contains all the Cycle times defined for 
a workflow. 

Attributes : 



IDEN 


lBPDid 


IDEN 


lWFDid 


LONG 


ITimel 


LONG 


lTime2 


LONG 


lTime3 


LONG 


lTime4 



Methods : 



DFWFCYCLETIMES 


This is the constructor 
for this class that 
creates a new record with 
the given cycle times for 
a criven WFDid and BPDid 


BOOL bfnGetCycleTimes 


Returns the cycle times 
(in context of the Class 
Attributes) 


DFWFCYCLETIMES 


Returns the first record 
from the table which 
matches the predicate 


IDEN lfnGetWFDid 


Returns the WFDid (in 
context of the Class 
Attributes) 



DFWFD I SABLE D ACTS 

This Class contains information of all the Disabled 

Acts . 
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Attributes 



IDEN 


lBPDid 


IDEN 


lWFDid 


WFROLE 


WFRole 


ACT 


Act Id 


Methods 



DFWFDISABLEDACTS 


This is the constructor 
for this class that 
creates a new record 
with the given WFrole 
and Actid for a given 
WFDid and BPDid 


BOOL bfnlsDisabled 


Returns whether a 
particular Act for a 
particular WFRole in a 
given workflow is 
disabled or not. 



DFWFACT STATE 

This contains all the definitions of the workflow 
acts and States (their names and IDs) for all business 
processes and their workflows. 

Attributes 



IDEN 


lBPDid 


IDEN 


lWFDid 


BOOL 


bActOrState 


INT 


ActOrState 


CHAR 


szUserDef Name [USERDEF STRING LEN] 


CHAR 


szGenScript [BLOBNAME LEN] 


CHAR 


szUserScriot [BLOBNAME LEN] 



Private Methods : 



BOOL bfnlsAvail 


Returns whether an Act/ 
state is Available for a 
qiven Workflow. 


BOOL bfnGetScriptName 


Returns the Script Name 
given the BP and WF DIds 
the Act/State and the 
type of script (User 
Defined or System 
Generated) required . 
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Methods 



DFWFACTSTATE 


This is the Constructor 
for this Class that 
creates a new recoro witn 
the given Act/State , and 
user defined name for a 
given WFDid and BPDid 


BOOL bfnPutScript 


Inserts the given Script 

i n t* <*> a. Vi 1 r>h *f *i 1 p 


DFWFACTSTATE 


Returns the first record 
from the table which 
matches the predicate 


BOOL bfnGetWFScript 


Returns the required data 
from the script file (In 
context of the Class 
Attributes) given the 
Script Type 



DFWFCONTAINER 

This class contains the Workflow Container 
Information (the Container ID for a particular workflow 
in a given BP) . 

Attributes : 



IDEN 


lBPDid 


IDEN 


lWFDid 


IDEN 


IContainerld 



Methods 



DFWFCONTAINER 


Creates a new Container 
Definition for a workflow with 
the given parameters (in 
context of the Class 
Attributes) 


IDEN lfnGetContainerld 


Returns the Container ID (in 
context of the Class 
Attributes) 



DFWFACTSTATEBDREF 

This Class contains the workflow Act/State Bound 
Data reference information. 
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Attributes 



IDEN 


lBPDid 


IDEN 


IWFDid 


BOOL 


bActOrState 


INT 


ActOrStateld 


WFROLE 


WFRole 


IDEN 


IContainerld 



Methods : 



DFWFACTSTATEBDREF 


The Constructor for 
this Class that 
inserts a record 
with the with the 
aiven parameters 


IDEN lfnGetContainerld 


Returns the 
Container ID (in 
context of the Class 
Attributes) 


BOOL bfnGetFieidAttrList 


Returns the list of 
Field Attributes for 
the given conditions 
(parameter values ) 


BOOL bfnGetNumFieldAttrList 


Returns the number 
of Field Attributes 
for the given 
conditions 
(parameter values ) 



DFWFFOLLOWUP 

This class contains all the Follow-up information 
of a workflow. 
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Attributes 



IDEN 


IBPDid 


IDEN 


lWFDid 


BOOL 


bPRFUFlaa 


BOOL 


bPRFURecur 


LONG 


lPRFUOf fset 


INT 


iPRFUCount 


BOOL 


bPCFUFlaq 


BOOL 


bPCFURecur 


LONG 


lPCFUOffset 


INT 


iPCFUCount 


BOOL 


bCRFUFlaa 


BOOL 


bCRFURecur 


LONG 


ICRFUOffset 


INT 


iCRFUCount 


BOOL 


bPCRemFlaq 


LONG 


IPCRemOf f set 


BOOL 


bActNotifvFlaa 



Methods 



DFWFFOLLOWUP 


The constructor of this 
class that depending on 
its first parameter 
inserts a record in the 
FollowUp Table with the 
Given Parameters or 
returns the first record 
from the table which 
matches the predicate 


BOOL bfnGetPerfRespInfo 


Returns the Performer 
Response Information (in 
context of the Class 
Attributes) 


BOOL bfnGetPerf Complnf o 


Returns the Performer 
Completion Information 
(in context of the Class 
Attributes) 


BOOL bfnGetCustRespInfo 


Returns the Customer 
Response Information (in 
context of the Class 
Attributes) 


BOOL bfnGetPerfRemlnfo 


Returns the Performer 
Reminder Information (in 
context of the Class 
Attributes) 


BOOL bfnGetActNotifyFlag 


Returns the Notify flag 
(in context of the Class 
Attributes) 
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DFBDFX ELD LIST 



Attributes 



IDEN 


IBPDid 


char 


szFieldName [FIELDNAME LEN] 


IDEN 


lFieldld 



Methods 

No Methods 

Transactions Database 
TXBP INSTANCE 

This Class contains information of all instances of 
Business Process Transactions. This information consists 
of the Transaction ID of the Business Process (BPTid) , 
the Business Process definition ID (BPDid) , the BP Status 
and whether the BP Instance is active or not . 



Attributes 



IDEN 


lBPTid 


IDEN 


IBPDid 


BOOL 


blsAct ive 


BP STATUS 


BPStatus 
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Methods 



TXBP INSTANCE 


Tne Constructor tor tnis Class 
that returns the first record 
from the table which matches 
the predicate 


Create Instance 


Creates an instance of the 
given BP in the Transactions 
Database table 

\ lADr iWolANLt/ • DiSACllve will 

still be FALSE 


BOOL bfnActivate 


Changes the Status (blsActive) 
of the current BP (In context 
to the Class Attributes) from 
FALSE to TRUE 


BOOL bfnSetBPStatus 


Sets the BPStatus to the given 
status ID (In context to the 

V^ldbo nL L I lUULC o ) 


IDEN lfnGetBPDid 


Returns the BPDid of the 
Business Process Instance (In 
context to the Class 
Attributes) 


IDEN IfnGetBPTid 


Returns the BPTid of the 
Business Process Instance (In 
context to the Class 
Attributes) 


duul DrnrJumListDr 


Keturns tne nuiuDer or bfs tnat 
have been Instantiated 


BOOL bfnListBP 


Returns a list of all BPs that 
have been Instantiated to 
memory or to tne rue 
specified 


BOOL bfnDelete 


Deletes the BP transaction 
(specified by the class 

QL.L.1. i.JJULCo / JL J. Will L>I^CT LuUlC • 


BOOL bfnAbort 


Sets the BPStatus to ABORT (In 
context to the Class 
Attributes) (Further Actions 
are vet to be defined) 


BOOL bfnSuspend 

* 


Sets the BPStatus to SUSPEND 
(In context to the Class 
Attributes) (Further Actions 
are vet to be defined) 
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BOOL bfnNumListQueryQF 


Returns the number of BP 
Instances (instantiated 
between the specified start 
date and the end dates) for the 
given Identity, having the 
specified Organization Role, 
(If bPending is TRUE then only 
those BPs are included where 
Acts are oendinq) 


BOOL bfnListQueryWF 


Returns a list of all BP 
Instances (instantiated 
between the specified start 
date and the end dates) for the 
given Identity, • having the 
specified Organization Role, 
(If bPending is TRUE then only 
those BPs are included where 
Acts are pending) 



TXBPASSIGN 

This class contains all the Identity to 
Organization role mappings at the BP level for BP 
Transaction. These mappings if present override the 
corresponding DFBP ASSIGN mapping for a given BPDid for 
that particular instance of the BP (BPTid) . 



Attributes 



IDEN 


lBPTid 


IDEN 


lOrcrRole 


IDEN 


lldentitvld 



Methods 



TXBP ASSIGN 


The constructor of this 
class that depending on 
its first parameter 
creates a new BP 
assignment in a given 
BPTid with the given 
parameters or returns the 
first record from the 
table which matches the 
predicate 


IDEN lfnGetldentity 


Returns the Identity ID 
(in context of the Class 
attributes) 
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TXWF INSTANCE 

This Class contains information of all instantiated 
Workflows. This information consists of the Transaction 
IDs of the Workflow (WFTid) and the Business Process 
(BPTid) to which it belongs, whether it is a Primary 
workflow or not, the Workflow definition ID (WFDid) , the 
reply, completion and initiate date, the present State, 
the Customer and Performer for this workflow Instance, 
the conditions of satisfaction for this workflow and 
whether this workflow instance has been instantiated or 



not 




Attributes 


• 
• 


IDEN 


lBPTid 


IDEN 


lWFTid 


BOOL 


bCentralWFFlao 


IDEN 


lWFDid 


DATETIMET 


IReplyDate 


DATETIMET 


ICompletionTime 


DATETIMET 


UnitiateTime 


STATE 


Stateld 


IDEN 


lCustld 


IDEN 


IPerf Id 


BOOL 


bCOSFlag 


CHAR 


s zCondOf Sa t i S f n [ BLOBNAME LEN ] 


BOOL I blnstantiate 
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Methods 



TXWF INSTANCE 


The Constructor for 
this Class that returns 
the first record from 
the table which matches 
the predicate 


BOOL bfnlnstantiateCentralWF 


Creates an Instance of 
the Primary workflow of 
a BP Instance, given 
the BPDid and BPTid 
with the given 
parameters. For the 
given BPDid, the 
workflow with CWF Flag 
TRUE is fetched from 
the DFWF table to 
create this CWF 
instance. A new WFTid 
for this workflow 
Instance is returned 


BOOL bfnCreatelnstance 


Creates an Instance of 
the non Primary 
workflow of a BP 
Instance, given the 
BPDid and BPTid with 
the given parameters. A 
new WFTid for this 
workflow Instance is 
returned 


BOOL bfnSetState 


Sets the STATE of the 
given workflow Instance 
to the state specified. 


BOOL bfnGetlnstantiate 


Returns the Status of 
the Instantiate flag 
for the given workflow 
Instance (In context of 
the Class Attributes) . 
This indicates if the 
specified workflow 
instance has been 
instantiated or not. 


BOOL bfnModify 


Modifies the specified 

WFInstance (In context 
of the Class 
Attributes) and returns 
the WFTid 


IDEN lfnGetCustld 


Returns the Customer ID 
for the given workflow 
Instance (In context of 
the Class Attributes) 
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IDEN lfnGetPerf Id 


Returns the Performer 
ID for the given 
workflow Instance (In 
context of the Class 
Attributes) 


BOOL bfnGetStateName 


Returns the User 
Defined State Name 
corresponding to the 
current state of the 
workflow Instance, (In 
context of the Class 
Attributes) . 


BOOL bfnGetFormName 


Returns the form name 
(corresponding to the 
WFRole) of the workflow 
Instance, (In context of 
tne Class AttriDutes; 


BOOL bfnlsCentralWF 


Returns TRUE if the 1 
current WF is a primary 
WF 


IDEN lfnGetBPTid 


Returns the BPTid for 
the given workflow 
Instance (In context of 
the Class Attributes) 


IDEN IfnGetWFTid 


Returns the WFTid for 
the given workflow 
Instance (In context of 
the Class Attributes) 


BOOL bfnResetlnstantiate 


Sets the Instantiate 
Flaa to FALSE 


IDEN lfnGetWFDid 


Returns the WFDid for 
the given workflow 
Instance (In context of 
the Class Attributes) 


STATE ifnGetState 


Returns the current 
State of the given 
workflow Instance (In 
context of the Class 
Attributes . 


BOOL bfnGetPending 


Return whether or not 
an act is pending for 
this Workflow Instance 


BOOL bfnPutCOS 


Creates/Appends to the 
Blob file of the 
workflow Instance, the 
COS data in memory 
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BOOL bfnGetCOS 


If the COSFlag is TRUE 
it retrieves the 
specified number of 
bytes from the Blob 
file of this workflow 
Instance containing the 
Conditions of 
Satisfaction else the 
COS is retrieved from 
the workflow 
Definitions table 


BOOL bfnPutCustld 


Modifies the Customer 
ID for this WF Instance 
to the given ID (in 
context of the Class 
attributes) 


BOOL bfnPutPerfld 


Modifies the Performer 
ID for this WF Instance 
to the given ID (in 
context of the Class 
attributes) 


LONG lfnGetReplyDate 


Returns the Reply date 
for this workflow 
Instance (in context of 
the Class attributes) 


LONG IfnGetCompletionTime 


Returns the Completion 
date for this workflow 
Instance (in context of 
the Class attributes) 


BOOL bfnPutReplyDate 


Modifies the Reply date 
for this WF Instance to 
the given date (in 
context of the Class 
attributes) 


BOOL bfnPutCompletionTime 


Modifies the Completion 
date for this WF 
Instance to the given 
date (in context of the 
Class attributes) 


BOOL bfnGetCOSFlag 


Returns the COS Flag 
for this workflow 
Instance (in context of 
the Class attributes) 


BOOL bfnPutCOSFlag 


Modifies the COS Flag 
for this WF Instance to 
the given value (in 
context of the Class 
attributes) 
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TXWFOBS 

This class contains the Workflow Observer 
Transactions information which includes information such 
as the WFTid, the BP Instance (BPTid) to which this 
workflow belongs, and the Observer ID for the workflow 
instance . 



Attributes 

private : 



IDEN 


lBPTid 


IDEN 


lWFTid 


IDEN 


lObserver 



Methods 



TXWFOBS 



The constructor of this 
class that depending on 
its first parameter it 
creates a new Workflow 
Observer Transaction in 
the Table with the 
given parameters or 
returns the first 
record from the table 
which matches the 
predicate 



TXWFASSIGN 

This class contains all the Identity to Organization role 
mappings at the Workflow level for Workflow Instances . 

Attributes 



private : 



IDEN 


lBPTid 


IDEN 


lWFTid 


IDEN 


lOraRole 


IDEN 


lldentitvld 


WFROLE 


WFRole 



SUBSTITUTE SHEET (RULE 26) 



82 

WO 94/18620 PCT/US94/01287 



Methods 



TXWF ASSIGN 


The constructor of this 
class that depending on its 
first parameter returns the 
first record from the table 
which matches the predicate 
or creates a new workflow 
assignment in a given WF 
instance \r*t iiu) ior a or 
Instance (BPTid) with the 
aiven parameters 


WFROLE fnGetWFRole 


Returns the WFRole (in 
context of the Class 
attributes) 


IDEN lfnGetldentity 


Returns the Identity ID (in 
context of the Class 
attributes) 



TXWF I NCOMP LETION 

This class contains the Incomplet ions information 
for all Instantiated workflow 

Attributes : 



IDEN 


lBPTid 


IDEN 


lWFTid 


INCOMPLETION 


Incld 


LONG 


IComplet ionTime 


LONG 


IFollowUpTime 


LONG 


IReminderTime 


LONG 


ICount 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



83 



PCT/US94/01287 



Methods 



TXWF INCOMPLETION 


The Constructor for 
this class that returns 
the first record from 
the table which matches 
the predicate or 
inserts a new workflow 
Incompletion for a 
given workflow Instance 
(WFTid) for a BP 
Instance (BPTid) with 
tne Qiven parameters 


IDEN lfnGetBPTid 


Returns the BPTid for 
the workflow Instance 
(in context of the 
Class attributes) 


IDEN lfnGetWFTid 


Returns the WFTid for 
the workflow Instance 
(in context of the 
Class attributes) 


INCOMPLETION fnGetlndd 


Returns the 

Incompletion ID for the 
WF Instance (in context 
of the Class 
attributes) 


DATETIMET 
lfnGetCompletionTime 


Returns the Completion 
Time for the WF 
Instance (in context of 
the Class attributes) 


VOID vfnPutCompletionTime 


Modifies the Completion 
time for this workflow 
Instance to the given 
time (in context of the 
Class attributes) 


DATETIMET If nGetFollowUpTime 


Returns the FollowUp 
Time for the WF 
Instance (in context of 
the Class attributes) 


VOID vfnPutFollowUpTime 


Modifies the follow up 
time for this workflow 
Instance to the given 
time (in context of the 
Class attributes) 


DATETIMET If nGetReminderTime 


Returns the Reminder 
Time for the workflow 
Instance (in context of 
the Class attributes) 
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VOID vfnPutReminderTime 


Modifies the Reminder 
Time for this workflow 
Instance to the given 
time (in context of the 
Class attributes) 


BOOL bfnGetFirst Incompletion 


Returns TRUE if a 
record for the given 
reminder/followup prior 
to the given time is 
available and the 
Incompletion 
information is made 
available in the Class 
Attributes . 


BOOL bfnGetNext Incompletion 


Returns TRUE if the 
next record for the 
given reminder/followup 
prior to the given time 
is available and the 
Incompletion 
information is made 
available in the Class 
Attributes . 


LONG lfnGetCount 


Returns the Count 
(number of 

incompletions) for the 
workflow Instance (in 
context of the Class 
attributes) 


VOID vfnlncCount 


Increments the count. 



TXWF AVAIL ACTS 

This class contains information of available acts for a 
Workflow Instance. 



Attributes : 



IDEN 


lBPTid 


IDEN 


lWFTid 


WFROLE 


WFRole 


ACT 


Act 


BOOL 


bReplvFlaa 


BOOL 


bComplet ionFlaq 
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Methods 



TXWFAVAILACTS 


The constructor for this 
Class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
new Available Act for a 
given workflow Instance 
(WFTid) for a BP 
Instance (BPTid) with 
the aiven parameters 


BOOL bfnNumAvailActs 


Returns the number of 
Acts available for a 
given WFRole in a 
WFInstance. The Impure 
Flag indicates whether 
an Act is waiting to be 
processed by the 
Transaction Manaaer 


BOOL bfnList 


Returns the list of Acts 
available for a given 
WFRole in a WFInstance. 
The Impure Flag 
indicates whether an Act 
is waiting to be 
processed by the 
Transaction Manager 


BOOL bfnDeleteAllActs 


Deletes all the Acts for 
a given workflow 
instance from the 
Available Acts table 


BOOL bfnGetReplyFlag 


Returns the value of the 
Reply Flag for the WF 
Instance (in context of 
the Class attributes) 


BOOL bfnGetCompletionFlag 


Returns, the Completion 
Flag for the workflow 
Instance (in context of 
the Class attributes) 



TXWFACTS 

This class contains information of Acts that are to be 
taken (Queue) in all Workflow instances . (Acts taken by 
the client but not yet processed by the Server) . 
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Attributes 





1 Ty T r\ 


DUUi) 


hQTFF Ian 


Tnrvi 
lUttVi 






x r» r J. xu 


ACT 


Act id 


WFROLE 


WFRole 


LONG 


IReplvTime 


LONG 


IComoletionTime 


IDEN 


IWho 


DATETIMET 


IWhenReaistered 


DATETIMET 


IWhenTaken 


BOOL 


bProcessed 


LONG 


IReturnCode 
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Methods 



TXWFACTS 


The Constructor for this 
Class that or inserts a 
new WF Act into the 
table (act Id) for a 
given WF Instance 
(WFTid) in a BP Instance 
(BPTid) with the given 
parameters or inserts a 
new WF Act into the 
table (Actid) for a 
given WF Instance 
(WFTid) in a BP Instance 
(BPTid) with the given 
parameters . It also 
inserts a record in the 
table TXSTFADDINFO or 
returns the first record 
from the table which 
matches the Dredicate 


IDEN IfnGetTxId 


returns the Tx ID for 
the Act that has to be 
taken (in context of the 
Class attributes) 


BOOL bfnGetReturns 
• 


Returns the parameters 
STFProcId, ReturnCode 
from the current Class 
attribute values. It 
also returns STFTxID and 
Userld (from 
TXSTFADDINFO) 


VOID vfnPutRetValue 


Modifies the Return 
Code. 


BOOL bfnGetFirstlnQueue 


Returns the first Act 
(to be processed ) from 
the Queue) 


VOID vfnActComplete 


Updates the bProcessed 
flaa to TRUE 


BOOL bfnCheckValidAct 


Checks if the given Act 
is valid for the WFRole 


IDEN lfnGetBPTid 


Returns the BPTid to 
which this Act belongs 
(in context of the Class 
attributes) 


IDEN IfnGetWFTid 


Returns the WFTid to 
which this Act belongs 
(in context of the Class 
attributes) 
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ACT fnGetAct 


Returns the Actid of 
this Act belongs (in 
context of the Class 
attributes) 


WFROLE fnGetWFRole 


Returns the WFRole 
taking this Act (in 
context of the Class 
attributes) 


STATE fnGetWFState 


Returns the State of 
this Act (in context of 
the Class attributes) 


WFTYPE fnGetWFType 


Returns the WFType (got 
from DFWF) of the 
workflow to which this 
Act belongs (in context 
of the Class attributes) 


DATETIMET 
If nGet Incomplet ionTime 


Returns the 
completion/reply time 
for the given 
IncomDletion 


DATETIMET 
If nGet Comp let ionTime 


Returns the completion 
time (in context of the 
Class attributes) 


DATETIMET If nGetReplyTime 


Returns the reply time 
(in context of the Class 
attributes) 


BOOL bfnNumListActTaken 


Returns the Number of 
acts present in the 
Queue for the given 
BPTid and WFTid 


BOOL bfnListActTaken 


Returns the list of acts 
present in the Queue for 
the given BPTid and 
WFTid to memory or a 
specified file 



TXSTFADDINFO 

This class contains additional information for all 
transactions which come via the STF Processor 

Attributes : 



IDEN 


ITxid 


IDEN 


ISTFProcId 


IDEN 


ISTFTxId 


IDEN 


lUserld 
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This class contains information of all outgoing 
Transactions via the STF Processor. 



Attributes 



IDEN 


ISTFProcessor 


IDEN 


lBPTid 


IDEN 


IWFTid 


NOTIFICATION 


NEvent 


IDEN 


lUserld 


DATETIMET 


IComDiet ionT ime 


DATETIMET 


INotif icationTime 


DATETIMET 


lWhenRecristered 


DATETIMET 


IWhenRead 


IDEN 


ITxId 



Methods 



TXSTFQUEUE 


The Constructor for this 
class 


BOOL bfnGetEvent 


returns the earliest 
Message Record (When 
Registered has the 
earliest date, and 
WhenRead is 0) from the 
STF Queue for the given 
STF Processor 


BOOL bfnSetRea'dTime 


Sets the WhenRead 
DateTime field to the 
given Value (In context 
to the Class Attributes) 


BOOL bfnPutEvent 


Inserts a record into 
the STFQueue with the 
given parameters (Sets 
WhenRead to 0 and 
WhenRegistered to the 
Current Time) . 



TXBPBD 

This class contains BP level Bound Data field IDs and 
values related to all BP Instances 
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Attributes 



IDEN 


lBPTid 


IDEN 


IFieldld 


CHAR 


szValueTINIT VAL LEN] 



Methods 



TXBPBD 



The constructor of this 
class that depending on 
its first parameter that 
inserts a Record in the 
TXBPBD table for the 
given BP Transaction 
with BPTid and Fieldld 
(which is obtained from 
DFFIELDLIST using the 
Field Name) and the 
field value or returns 
all the Bound Data 
fields (associated with 
the given BP Instance, 
BPTid) . to specified 
file/memory or returns 
the number of Bound 
Data fields associated 
with the given BP 
Instance (BPTid) 



TXWFBD 

This class contains workflow level Bound Data field IDs 
and values related to all instantiated WFs in BP 
Instances 



Attributes 



IDEN 


lBPTid 


IDEN 


IWFTid 


IDEN 


IFieldld 


CHAR 


szValueflNIT VAL LENT 
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Methods 



TXWFBD 



The constructor of this 
class that depending on 
its first parameter 
inserts a record in the 
TXWFBD table for the given 
WF Instance (WFTid) in the 
specified BP Transaction 
with WFTid , BPTid ,FieldId 
(which is obtained from 
DFFIELDLIST using the 
Field Name) and the field 
value or returns the 
number of Bound Data 
fields associated with the 
given WF Instance in the 
specified BP Transaction ( 
BPTid) returns all the 
Bound Data fields 
(associated with the 
given WF Instance in the 
specified BP 
Transaction (BPTid) ) . to 
specified file /memory 



Global Method 



BOOL bfnlsPure 



This method returns TRUE 
if there are no acts 
pending in the TXWFACTS 
Queue for the given WF 
Instance in the specified 
BP Transaction. If there 
are acts in the Queue then 
it returns FALSE . 



Names and Routings Database 



DFSTFPROC 

This class contains information of all STF 
Processors including their IDs , names and network 
addresses . 



Attributes 



IDEN 


ISTFProcId 


CHAR 


szSTFProcName [STFPROCNAME LEN1 


CHAR 


s zNet Address TNETADDRESS LEN! 
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DFSTFPROC 


The Constructor for this 
Class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the DFSTFPROC 
table for the given STF 
Processor Name and 
Network Address It 
generates the STFProcId 
and returns it 


BOOL bfnGetSTFProcName 


Returns the STF 
Processor Name (in 
context of the Class 
attributes) 


BOOL bfnGetNetAddress 


Returns the Network 
Address of the STF 
Processor (in context of 
the Class attributes) 


BOOL bfnDelete 


Deletes the record from 
the DFSTFPROC table 
whose values are in 
context of the class 
attributes . 


BOOL bfnListSTFProcs 


Returns information of 
all STF Processors in a 
set of Structures . 



NRDFORGROLE 

This Class contains the Organization Role ID to 
Organization Role Name mapping. 

Attributes : 



IDEN 


lOraRole 


CHAR 


szOraName fORGROLE LENT 
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Methods 



NRDFORGROLE 


The Constructor for this 
Class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the NRDFORGROLE 
table containing the 
OrgRole ID and the 
corresponding Name 


IDEN lfnGetOrgRole 


Returns the OrgRole ID 
(in context of the Class 
attributes) 


BOOL bfnDelete 


Deletes the record from 
the NRDFORGROLE table 
whose values are in 
context of the class 
attributes . 



NRDF IDENTITY 

This class contains information related to all the 
Identities including their Name, Network Address, Postal 
Address, Phone/Fax and other information. 

Attributes : 



IDEN 


lldentitvld 


CHAR 


s zldent it vName f IDENTITY LEN1 


CHAR 


SzNetAddress [NETADDRESS LEN] 


CHAR 


szPostalAddress f POSTALADDRESS LEN] 


CHAR 


szPhone [PHONE LEN1 


CHAR 


szFax f PHONE LENT 


CHAR 


szDepartment [DEPARTMENT LENT 


CHAR 


szTitle [TITLE LEN1 


CHAR 


sz Location [LOCATION LEN] 


CHAR 


szComment [COMMENT LEN] 


BOOL 


bNotifv 


IDEN 


ISTFProcId 
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Methods 



NRDFIDENTITY 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the 
NRDFIDENTITY table 
containing the 
Identityld/ the 
corresponding Identity 
name, and other Identity 
information obtained from 
the qiven parameters 


BOOL bfnDelete 


Deletes the record from 
the NRDFIDENTITY table 
whose values are in 
context of the class 
attributes . 


BOOL bfnGetNotify 


Returns the Notify Status 
(in context of the Class 

u w i» ^ ^i>j u iv w *j / • 4 1 \^ ^ x. y 

Status will be TRUE if 
the Identity wants a 
Notification of an event . 


IDEN lfnGetSTFProdd 


Returns the STF Processor 
ID (in context of the 
Class attributes) . If the 
Identity is not an STF 
Processor then 0 is 
returned. 


IDEN lfnGetldentityld 


Returns the Identity ID 
(in context of the Class 
attributes) . 


BOOL bfnGetldenNameList 


Returns information of 
all Identities in a set 
of Structures . 


NRDFGROUP 

This class contains all the Groupld to Group Name 
mapping . 

Attributes 



IDEN 



CHAR 



IGroupId 



szGrouoName [GROUPNAME LEN] 
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Methods 



NRDFGROUP 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the NRDFGROUP 
table containing the 
Groupld, and the 
correspondincr Group name 


BOOL bfnDelete 


Deletes the record from 
the NRDFGROUP table whose 
values are in context of 
the class attributes. 


IDEN lfnGetGroupId 


Returns the Group ID (in 
context of the Class 
attributes) . 



NRDFGROUP AS SIGN 

This class contains all the Groupld to Identityld 
mapping . 

Attributes : 



IDEN 


IGroupId 


IDEN 


lldentitvld 
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Methods 



NRDFGROUP ASSIGN 


Tne constructor xor 
this class that returns 
the first record from 
the table which matches 
the predicate or 

m n mm mm. mm 4 ^» |^ 

inserts a Recora in tne 
NRDFGROUP ASSIGN table 
containing the Groupld, 
and the Identity Id 


BOOL bfnDelete 


-—- 1 -— - — _ — * - - — i— . mm, mm. mm* mm* ^m, mmm. 

Deletes the recora from 
the NRDFGROUP ASSIGN 
table whose values are 
in context of the class 
attributes . 


BOOL bfnNumListGroup 


Returns the number of 

' - (~ — «. n mm. * * m. m** m mm. 

Groups wnicn contain 
the given Identityld as 
a member 


BOOL bfnListGroup 


Returns information of 
all Groups which 
contain the given 
Identityld as a member, 
to file or memory as 

O C -L J. 


BOOL bfnNumListlden 


Returns the number of 
Identities in the 
specified GrouDlD 


BOOL bfnListlden 


Returns information of 
all Identities which 
belong to the specified 
group, to file or 
memory as specified 



NRDFGROUP ROLEASS I GN 



Attributes 



IDEN 


lGroupId 


IDEN 


lOrcrRole 
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Methods 



NRDF GROUP ROLE AS S I GN 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
record in the NRDFGROUP- 
ROLEASSIGN table 
containing the Groupld, 
and the Organization Role 


BOOL bfnDelete 


Deletes the record from 
the NRDF GROUP- ROLEASSIGN 
table whose values are in 
context of the class 
attributes . 


BOOL bfnNumListRole 


Returns the number of 
Groups which contain the 
given Organization Role 
as a member 


BOOL bfnListRole 


Returns information of 
all Groups which contain 
the given Organization 
Role as a member/ to file 
or memory as specified 


BOOL bf nNumListGroup 


Returns the number of 
Organization Roles in the 
specified GroupID 


BOOL bfnListGroup 


Returns information of 
all Organization Roles 
which belong to the 
specified group r to file 
or memory as specified 



NRDFIDENROLEASSIGN 

This class contains all the Identityld Organization Role 
mapping . 



Attributes 



IDEN 


lldentityld 


IDEN 


lOrcrRole 
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Methods 



NRDF IDENROLEASS IGN 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the NRDFIDEN- 
ROLEASSIGN table 
containing the 
Identityld, and the 
Organization Role 


BOOL bfnDelete 


Deletes the record from 
the NRDF I DEN- ROLEASSIGN 
table whose values are 
in context of the class 
attributes . 


BOOL bf nNumListRole 


Returns the number of 
Org. Roles which contain 
the given Identityld as 
the Identity Id 


BOOL bfnListRole 


Returns information of 
all Org. Roles which 
contain the given 
Identityld as the 
Identity ID, to file or 
memory as specified 


BOOL bfnNumList Identity 


Returns the number of 
Identities with the 
specified Orq. Role 


BOOL bfnListldentity 


Returns information of 
all Identities with the 
specified Org. Role, to 
file or memory as 
specified 



Schedule Database 

This class contains all the Business Process 
schedule information including time when it has to be 
next initiated and the Recurring period of that BP 

SCBPSCHEDULE 



Attributes 



IDEN 


lBPDid 


DATETIMET 


UnitTime 


DATETIMET 


IRecPeriod 
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Methods 



SCBPSCHEDULE 


The Constructor for this 
class that inserts a 
Record in the SCBPSCHEDULE 
table for the given STF 
Processor Name and Network 
Address It generates the 
STFProcId and returns it 
or returns the first 
record from the table 
which matches the 
predicate 


BOOL bfnDelete 


Deletes the record from 
the SCBPSCHEDULE table 
whose values are in 
context of the class 
attributes . 


DATETIMET If nGet InitTime 


Returns the Initiation 
Time of the BP (in context 
of the Class attributes) 


DATETIMET If nGetRecTime 


Returns the Recurring 
period of the BP (in 
context of the Class 
attributes) 


IDEN IfnGetBPDid 


Returns the BP ID (in 
context of the Class 
attributes) 


VOID vfnPutlnitTime 


Updates the Initiation 
Time for the BP with the 
specified time (in context 
of the Class attributes) 


BOOL bfnGetFirstBPSchedule 


Returns the first BP 
scheduled to be Initiated 
(Where the InitTime is 
less than the specified 
time) (the Class 
attributes are updated) 


BOOL bfnGetNextBPSchedule 


Returns the next BP 
scheduled to be Initiated 
(Where the InitTime is 
less than the specified 
time) (the Class 
attributes are updated) 



AWSAUTH 

This class contains information related to each 
Identities database access privileges. 
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IDEN 


lldentitvld 


OBJECT TYPE 


Obiectld 


PRIVILEGES 


Privileae 



BOOL Grant 


Updates the privileges of 
the specified Identity to 
the given set of 
Privileaes 


BOOL Revoke 


Revokes the specified 
privileges from the 
specified Identity 


BOOL InquireAuth 


Returns the Privileges of 
the specified Identity 



CONFIGINFO 

This Class contains the configuration information of a 
particular installation including the path and file name 
of the Logfile, the interval of the Server polling, the 
path of the Blob file and the maximum number of BP 
instances . 



CHAR 


szLocrFilePath [LOGFILEPATH LEN ] 


CHAR 


szLoaFileName f LOGFILENAME LEN ] 


INT 


iPollInterval 


CHAR 


szBlobFilePath [BLOBFILEPATH LEN] 


INT 


iMaxBPInst 


LOGOPTIONS 


LoaOpts 


Methods 



BOOL bfnSetConf iglnfo 



Sets the configuration of 
an installation to the 
specified values 



BOOL bfnGetConf iglnfo 



Returns the Configuration 
of the Installation . 



ERRMSG 

Contains the Error code to error Number mapping 



Attributes 



INT 


iErrNo 


LONG 


lErrCode 
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ERRMSG 


The Constructor for this 
Class 


BOOL bfnPutErrNo 


Inserts a record with an 
ErrNo and the 
corresponding ErrCode, 


INT ifnGetErrNo 


Gets the ErrNo 
corresponding to the 
specified ErrCode. 



MESSAGEQ 

This Class contains the Message Queue which is used by 
the components of the Server for internal communication 

Attributes 



PROCESS 


Sender 


PROCESS 


Recipient 


MESSAGE 


Message 


LONG 


lParaml 


LONG 


lParam2 


LONG 


lParam3 


LONG 


lParam4 


CHAR 


szParam f PARAM LEN] 


DATETIMET 


lWhenPosted 


Methods 



MESSAGEQ 


The Constructor for this 
class 


BOOL bfnPostMessage 


Puts the given message 
into the Message Queue 
with the specified 
Sender and Recipient 
fields 


BOOL bfnGetMessage 


Gets the first message 
marked to the specified 
recipient from the 
Message Queue. 


BOOL bfnFlushMessage 


Deletes all messages 
from the Message Queue. 



Administration and Configuration Database 
Server Management 



ServerMgmt 

Attributes 

lServerld 



identifier 
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string [sz_servername] 

/* The method 
StopServer should 
find all BPs that 
have the server as 
Home & issue 
warning to the 
current users */ 

Login 
Logout 

ListLoginActvities 
User Maintenance 



szServerName 
Methods 

StartServer 
StopServer 



UserMaint 

Attributes 

LoginName 
Password 
Methods 

AddNewUser 
RemoveUser 
ModifyUserlnfo 



ref (Identity) 

string 

string 



or ref (Group) 



Authorization Maintenance 



Object 

Attributes 



Qbjectld 
Ob jectType 



ref (BP) or ref(WF) or 

ref (STFProcessor) 

ob jecttype 



AuthMaint 

Attributes 

User ref (User) 

Ob-iectld ref (Object) 

Privilege privilege 
GrantOption bool 

Methods 
Grant 
Revoke 

InquireAuthorization 

Business Process Maintenance 



BPMaint 

Methods 

AbortBP 
* DeleteBP 
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SuspendBP 

ResumeBP 

ArchiveBP 

ListAvailBPs 

ListActiveBPs 

DeleteBPDef inition 



Workflow Maintenance 



WFMaint 

Methods 

ListAllWF 



STF Processor Maintenance 



STFMaint 

Methods 

RegisterSTFProc 
DeregisterSTFProc 



Backup and Restore 



Backup 



Attributes 
BPTd 



BackupPate 
BackupTime 
BackupMedia 



string 



time 
time 
enum 



/* Business 
Process name is 
NULL, implies 
backup/restore 
entire DB */ 



Methods 

Backup 
Restore 



Database Management 

DBMgmt 

Methods 

CheckDatabase 
IndexDat abase 
ReorganizeDat abase 



Configuration 



Conf ig 

Attributes 

MaxUserCount int 
MaxOpenBPs int 
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Version string 

Methods 

SetConf iguration 
Get Configuration 



STF Queue Database 

STF Additional Information Class 

The server as a service stores additional fields 
required by STF processors. The STF Processor Id, the STF 
Transaction Id and the User Id are stored. 

TxSTFAddllnf o 

The STF Queue database is implemented through two 
classes TXSTFADD INFO and TXSTFQUEUE which are desribed 
with other classes of the transaction database. 

B. WORKFLOW APIs 

Workflow Transactions API 

This section describes the functions performed by 
the transactions API . A description of each function is 
set forth followed by the syntax of a call to the 
function, with specification of each parameter passed to 
the function. From this information, a suitable code 
segment can be written to implement the function. 

AWSTINITBP 

Description 

This function creates a new instance of a 
previously defined Business Process (BP) . The BP Name is 
passed and a BP Id is returned. This Id will be required 
for all subsequent calls to this API. This call also 
activates the Primary workflow. To create this instance 
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« _ 

of the Business Process the Name specified for the 
IdentityNarae must be authorized. Optionally the mapping 
of Organization Role Names to Identity Names may be 
provided. This . overrides the default mapping (if any). 

Syntax 

VOID FAR PASCAL AWSTINITBP (STRING szBPName, 

STRING szlnitiatorName, STRING 
szCustomerName, STRING szPerf ormerName, 
DATETIMESTRING szComplet ionDate, 
DATETIMESTRING szResponseDate , 
DATETIMESTRING szlnit iateDate , 
INT iCount, LPORG2ID lpOIPtr, 
LPIDEN lpBPTid, STRING szCWFName, 
LPERRCODE IpError) 
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parameters ■ 

— l^vne Description „ 


szBPName 


STRING 


Business Process 
Name. This BP must 
have previously 
been defined and 
the name known to 
the server. 


szlnitiatorName 


STRING 


Name of the person 
or identity 
initiating the 
business process. 
The identity must 
be authorized to 
activate the 
business process. 




STRING 


Customer Identity 
Name . 


szPerf ormerName 


STRING 


Performer Ident ity 
Name . 


szCompletionDate 


DATETIMESTRING 


The date by which 
the Primary 
workflow must be 
completed . 


szResponseDate 


DATETIMESTRING 


The date by which 
negotiation must be 
complete . 


szlnitiateDate 


DATETIMESTRING 


The Date when this 
workflow is to be 
initiated by the 
server. If this 
date is not 
specified then the 
Business Process is 
initiated 
immediately . 


iCount 


INT 


The number of 
Organization Role 
to Identity mapping 
entities . 
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lpOIPtr 


LPORG2ID 


Pointer to an array 
of structures which 
contains the 
mapping of 
Organization Role 
to Identities. In 
the structure 
ORG2ID, the 
application must 
set the GLOBAL or 
LOCAL flag to 
identify whether 
une uisoziu 
overriding is at BP 
level or at WF 
level. 


lpBPTid 


LPIDEN 


returns BPTid. 


szCWFName 


STRING 


returns the name of 
Primary Workflow. 


lDError 


LPERRCODE 


Error Code. 



Return Value 

The function returns the Business Process Instance 
Id, BPTid and Primary WF name, szCWFName. 



AWSTINITWF 

Description 

The business process this workflow belongs to must 
have been instantiated. The application must supply the 
Business Processes' Business Process Transaction Id. The 
Identity Names of the Customer and Performer are optional 
if defaults have been specified. The dates for completion 
and reply are optional. If these dates are NULL values, 
the defaults specified by the workflow's definition (if 
any) will be used. The Initiate date is optionally 
specified only for the Primary workflow to initiate it at 
a later date. Optionally the mapping of .Organization 
Roles to Identity Names may be passed. These override the 
default mapping if any. 
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VOID FAR PASCAL AWSTINITWF (BPTID lBPTid, STRING szWFName, 

STRING szlnitiatorName, STRING 
szCustomerName, STRING szPerf ormerName, 
DATETIMESTRING szCompletionDate, 
DATETIMESTRING szResponseDate , 
DATETIMESTRING szlnitiateDate , 
INT iCount, LPORG2ID lpOIPtr, 
LPERRCODE IpError) 
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Parameters 



Name 


I Type 


Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 


szWFName 


STRING 


The name of the workflow 
to be initiated. The 
primary workflow can be 
initiated prior to an 
initiation date specified 
in the AWSINITBP function, 
or a previously specified 
initiation date changed 
using this function by 
specifying the name of the 
primary workflow. If the 
specified workflow is not 
the primary workflow, then 
the Business Process this 
workflow belongs to mus- 
have already been 
initiated. 


szlnitiatorName 


STRING 


The Identity Name of the 
person initiating the 
workflow. The workflow 
will be initiated only if 
the identity has the 
authorization . 


szCustomerName 


STRING 


The Identity Name of the 
person who is the Customer 
for this workflow. 


szPerf ormerName 


STRING 


The Identity Name of the 
person, who is the 
Performer for this 
workflow. 


szCompletionDate 


DATETIMESTRING 


The date by which this 
workflow must be 
comDleted. 


szResponseDate 


DATETIMESTRING 


The date by which 
negotiation must be 
comolete . 


szlnitiateDate 


DATETIMESTRING 


The Date when this 
workflow is to be 
initiated by the server. 
If this date is not 
specified then the 
workflow is initiated 
immediately. This date can 
be specified only for the 
Primary workflow. 


iCount 


INT 


The number of Organization 
Role to Identity mapping 
entities . 
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lpOIPtr 


LPORG2ID 


Pointer to an array of 
structures which contains 
a mapping of Organization 
Role to Identity Names. 


loError 


LPERRCODE 


Error Code. 



Return Value 

None 

AWSTACTINWF 

Description 

This function instructs the workflow server to 
perform the act specified in the specified workflow of a 
specific business process. The Business Process 
Transaction ID and Workflow Name must be specified. The 
identity performing the act must be specified. The server 
records the act to be taken and updates the workflow. The 
server may take an unspecified time to take the act 
because of the queuing of the acts to be taken. If the 
client application issues a query when the act is 
pending, the application will receive status values which 
are not updated and this will be indicated by CLEAR or 
PENDING flag of the query APIs. 

Syntax 

VOID FAR PASCAL AWSTACTINWF (STRING szSTFProcName , 

STRING szSTFTxName, STRING szSTFUserName , 
BPTID lBPTid, STRING szWFName, ACT Act, 
DATETIMESTRING szCompletionDate, 
DATE TIME STRING szReplyDate, STRING 
szParticipantName, LPIDEN lpTxId, 
LPERRCODE IpError) 
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Parameters 





Name 


I Type 


I Description 




SzSTFProcName 


STRING 


Only the transaction cails 
made via STF Processor 
will pass this. Workflow 
applications which 
directly use this call 
should set this field to 
NULL. 




szSTFTxName 


STRING 


Only the transaction calls 
made via STF Processor 
will pass this. Workflow 
applications which 
directly use this call 
should set this field to 
NULL. 




szSTFUserName 


STRING 


Only the transaction calls 
made via STF Processor 
will pass this. Workflow 
applications which 
directly use this call 
should set this field to 
NULL. 




lBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 




szWFName 


STRING 


The Transaction Id of the 
workflow in which to take 
the act. 




Act 


ACT 


The act to take, e.g., 
Reouest, Agree, etc. 




szCompletionDate 


DATETIMESTRING 


Completion date can be 
optionally specified 
whenever permitted or 
recommended has to be 
specified for all Customer 
/ Performer Counter Acts. 




IReplyDate 


DATETIMESTRING 


Reply date has to be 
specified for the 
following acts: Customer / 
Performer Counters, 
Declare Completion and 
Declare dissatisfaction. 




szlnitiatorName 


STRING 


Identity of the person 
requesting the act. 




IpTxid 


LPIDEN 


Unique Transaction Id 
returned by the API. This 
Id is used to inquire 
about the status of taking 








the Act. 




IpError 


LPERRCODE 


Error code returned by the 
server . 
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Return Value 

The unique transaction Id generated by the server 
is returned. The application calling the transaction API , 
AWSTACTINWF can use this Id to inquire about the status 
of the Act. The API call to be used is 
AWSTACTSTATUSQUERY . 

. AWSTACTSTATUSQUERY 

Description 

This function gets the status of the Act requested 
by the AWE A via the transaction API call AWSTACTINWF. The 
Status indicates whether the act was taken successfully 
or an error occurred. In case of an error, a diagnostic 
error code will be returned. 

Syntax 

VOID FAR PASCAL AWSTACTSTATUSQUERY (IDEN lTxId, 

STRING szSTFProcName, STRING szSTFTxName , 
STRING szSTFUserName, LPERRCODE IpError) 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



113 



PCT/US94/01287 



Parameters 



Name 


Type 


Description 


lTxid 


IDEN 


Unique Transaction Id 
returned by the API - 
AWSTACTINWF. This Id is 
to be used to identify 
the Act being inquired 
about . 


szSTFProcName 


STRING 


Only the transaction 
calls made via STF 
Processor will get back 
the corresponding Id. 
Workflow applications 
which directly use the 
Transaction API can 
icrnore this parameter. 


szSTFTxName 


STRING 


Only the transaction 
calls made via STF 
Processor will get back 
the corresponding Id. 
Workflow applications 
which directly use the 
Transaction API can 
ianore this parameter. 


szSTFUserName 


STRING 


Only the transaction 
calls made via STF 
Processor will get back 
the corresponding Id. 
Workflow applications 
which directly use the 
Transaction API can 
ianore this parameter. 


IpError 


LPERRCODE 


Error code returned by 
the server. This 
indicates whether the 
Act was taken 
successfully or an 
error occurred. 



Return Value 

In case the call is made by a workflow application 
via an STF Processor, then the szSTFProcName, szSTFTxName 
and the szUserName are returned along with Error (which 
indicates the status of the Act) . If the call is made by 
an application directly, then the Application needs to 
check only the error code. 
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AWSTBINDAPPDATA 

Description 

Binds data- to a business process or workflow 
instance. Application data can be attached or bound to a 
business process or workflow. Later this information can 
be retrieved. The data field name and data value are 
supplied. Data type is specified at definition time. Any 
number of data items may be bound. When data is bound to 
the business process, the workflow name is specified by 
NULL. 

Syntax 

VOID FAR PASCAL AWSTBINDAPPDATA (BPTID lBPTid, STRING 

szWFName, STRING szParticipantName, 
INT iFields, 

LPTXBDFIELDSTRUCT lpTxBDFieldStruct Pt r , 
LPERRCODE IpError) 
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Parameters 



Name I Type I Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The 
Id of a previously 
instantiated BP. 


szWFName 


STRING 


The name of the 
workflow in which to 
bind the data. The 
workflow name is 
specified as NULL if 
data is to be bound 
to the business 
process . 


szParticipantName 


STRING 


Identity of the 
person requesting 
binding of 
application data. 


iFields 


INT 


The number of fields 
to bind with the 
workflow 


lpTxBDFieldStructPtr 


LPTXBDFIEL 
DSTRUCT 


A pointer to a array 
of structures 
containing the field 
name, type, size and 
the field value. The 
structure 
BDFIELDSTRUCT 
contains an element 
of type ATTRIBUTES. 
This parameter will 
be ignored by the 
API . 


IpError 


LPERRCODE 


Error code returned 
by the server. 



Return Value 

Data is bound to the workflow. 



AWSTGETAPPDATA 

Description 

A set of data fields and values are returned 
corresponding to the data fields bound to a workflow 
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instance. The number of fieicis and for each field the 
field name, type and its value are returned. 



Syntax 

VOID FAR PASCAL AWSTGETAPPDATA (BPTID lBPTid, STRING 

szWFName, STRING szFormName, 
WFROLE WFRole, STRING szPart icipaptName, 
LP INT lpiFieldsPtr, BOOL bFileOrMemory, 
LPADFIELDSTRUCT IpADFieldStructPtr, 
STRING szFileName, LPERRCODE IpError) 
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Parameters 



Name 


type 1 Description 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 


szWFName 


STRING 


The name of the workflow 
from which to retrieve 
bound data. The workflow 
name should be set to 
"GLOBALBPDATA" to 
retrieve business process 
bound data. 


szFormName 


STRING 


The form name is 
returned. This was stored 
along with the bound 
data . 


WFRole 


WFROLE 


The WFRole of the 
participant. This need 
only be specified if the 
participant has more than 
one role in the workflow. 


szParticipantName 


STRING 


The name of the person or 
identity requesting 
Application Data 
associated with the 
workflow . 


lpiFieldsPtr 


LP I NT 


The number of bound data 
field to be retrieved. 


bFileOrMemory 


BOOL 


Flag to indicate File or 
Memory mode of receipt of 
data from the API. 


lpBDFieldStructPtr 


LPBDFIELDSTRUCT 


A pointer to an array of 
structures, where the 
field name, type and the 
field values are 
returned. The structure 
ADFIELDSTRUCT contains an 
element of type 
ATTRIBUTES. This 
parameter is to be 
ignored by the 
Application. The API 
returns the list of 
attributes if 
bFileOrMemory is 
ITS_MEMORY . Application 
Data fields defined as 
HIDDEN for the particular 
WFRole , requesting 
Participant, and current 
workflow state are 
returned as NULL strinos. 
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szFileName 


STRING 


File name where the API 
should deposit the 
results of the call if 
the flag bFileOrMemory is 
ITS FILE. 


IpError 


LPERRCODE 


Error code returned by 
the server. 



Return Value 

lpiFields contains the number of fields retrieved. 
BDFieldStruct contains the field name, field type and 
field value for all the fields retrieved. 

AWSTGETAPPDATAFIELDATTRIBUTES 
Description 

This functions returns the list of application data 
field names arid their attributes for a specified act or 
state for a specific workflow of a Business Process. The 
attributes returned are Read-Only, Editable and Hidden. 
These attributes are Boolean. 

Syntax 

VOID FAR PASCAL AWSTGETAPPDATAFIELDATTRIBUTES (BP TID lBPTid, STRING 

szWFName, BOOL bActORState, ACTSTATE ActOrState, 
STRING szFormName, STRING szParticipantName, 
WFROLE WFRole, LP I NT lpiFields, 

LPFLDNAMEATTR lpFldNameAttr, BOOL bFileOrMemory, 
STRING szFileName, LPERRCODE IpError) 
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Parameters 



Name 


1 Type 


| Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. 
Tne id or a 
previously 
instantiated BP. 


s zWFName 


STRING 


The Transaction 
Id of the 
workflow from 
which to 
retrieve, field 
attributes of 
the bound data. 


bActORState 


BOOL 


Boolean flag to 

■i t"i fi i rat"P f V| c» 

type of the 

ACTSTATE 

parameter. 


ActOrState 


ACTSTATE 


The field 
attributes 
specified for 
this act or 
state are 
returned. 


3 2FormName 


STRING 


The form name is 
returned. This 
was stored along 
with the bound 
data . 


szParticipantName 


STRING 


The name of the 
person or 
identity 

requesting Field 
Attributes of 
the Application 
Data associated 
with the 
workflow . 


WFRole 


WFROLE 


The workflow 
role of the 
identity . 


lpiFieldsPtr 


LP INT 


The number of 
bound data 
iieias ior wmcn 
the attributes 
are returned. 


lpWFMomentBDField 


LPWFMOMENTBDF I E - LD S TRUCT 


A pointer to a 
array of 
structures 
containing the 
field name and 
field 

attributes . 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



120 



PCT/US94/01287 



bFiieOrMemory 


BOOL 


Flag co indicate 
File or Memory 
mode of receipt 
or aaca iroiu cne 
API . 


szFileName 


STRING 


File name where 

f ho APT Qhnnl H 

deposit the 
results of the 
call if the flag 
bFiieOrMemory is 
ITS FILE. 


IpError 


LPERRCODE 


Error code 
returned by the 
server. 



Return Value 

lpiFieldPtr is updated with the number of fields for 
which the field attribute is returned. 
FieldStruct contains the field attributes for the 
specified act. 

AWSTSTATUS 

Description 

This function returns status of the workflow 
instance for a specific participant . The state of the 
workflow, the current incompletions with the dates, etc. 
Information is returned in the STATUS structure. 

Syntax 

VOID FAR PASCAL AWSTSTATUS (BPTID lBPTid, STRING szWFName, . 

STRING szParticipantName, WFROLE WFRole, 
LPINT IpCurrent, LPSTATUS IpStatusPtr, 
LPERRCODE IpError) 
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Parameters 



f* o sues 


1 Tvoe 

1 1 1 IL 


1 Description 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 


s zWFName 


STRING 


The workflow name whose 
status is desired 


szParticipantName 


STRING 


The status of the workflow 
is returned with respect 
to this Identity. 


WFRole 


WFROLE 


The WFRole of the 
participant, xnis iieia 
is only required if the 
participant is both 
customer and performer. 


IpCurrent 


LP I NT 


The current status - CLEAR 
i.e.., no Acts in the 
queue waiting to be 
serviced or PENDING i.e.., 
some acts are in tne queue 
yet to be serviced. 


IpStatusPtr 


LPSTATUS 


The STATUS structure 
contains the Status String 
and various Completion and 
Reply dates. These dates 
depend on the role of the 
Identity- 


lpError 


LPERRCODE 


Error code returned by the 
server. 
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Return Value 

Structure Status contains the status of the specified 
workflow. 

Element Status . StatusString contains the string 

describing the current state of the workflow. 

The following Completion and Reply dates are returned: 



Customer 


Performer 


Completion reauested 


Completion due 


Reolv due to Performer 


Reply due to Customer 


Completion due by 
Performer 


Completion requested by 
Customer 


Reply due bv Performer 


Reoly due by Customer 



Not all dates are returned, depending on the present 
state of the workflow the relevant dates are returned. 

AWSTAVAILABLEACTS 

Description 

Returns a structure that contains the list of 
available acts in the specified workflow for the role 
that the participant has in the workflow. 

Syntax 

VOID FAR PASCAL AWSTAVAILABLEACTS (BP T ID IBPTid, 

STRING szWFName, WFROLE WFRole, 
STRING szParticipantName, BOOL cDialog, 
BOOL bFileOrMemory, LP INT lpiCountPtr, 
STRING szFileName, LPACTINFO ActPtr, 
LPERRCODE IpError) 
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Parameters 



Name 


f Type 


I Description 


lBPTid 


BPTID 


Business Process Transaction 
Id. The Id of a previously 
instantiated BP. 


szWFName 


STRING 


The name of the workflow whose 
status is desired 


WFRole 


WFROLE 


The workflow role of the 
identity. This field is only 
required if the participant is 
both customer and performer in 
the workflow. 


szParticipantName 


STRING 


The name of the person or 
identity for which the list of 
available acts is returned. 


cDialog 


BOOL 


If cDialog is TRUE, then a 
dialog box is presented to the 
user to select a specific act. 
In this case, the list of 
available actions returned by 
this function will be the 
selected one. 

If cDialog is FALSE, then no 
dialog box is presented and all 
available acts are returned. 


bF i 1 e 0 rMemo r y 


BOOL 


Flag to indicate File or Memory 
mode of receipt of data from 
the API. 


lpiCountPtr 


LP I NT 


Number of acts returned in the 
structure 


szFileName 


STRING 


File name where the API should 
deposit the results of the call 
if the flag bFileOrMemory is 
ITS FILE. 


lpActPtr 


LPACTINFO 


A pointer to an array of 
structures which contains the 
list of acts, i.e., Act Names, 
user-defined names for the 
acts . 


IpError 


LPERRCODE 


Error code returned by the 
server . 



Return Value 

lpiCountPtr is updated with the number of possible acts 
the Identity can take in the current workflow. 
The structure array passed is filled with the Acts Names 
and user-defined names. 
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Description 

This function returns the list of workflows that 
the named person or identity has as a specific 
Organization Role. The list of workflows is selected from 
the set of instantiated business processes that have the 
same business process name. The workflow status for each 
workflow is returned. 

Syntax 

VOID FAR PASCAL AWSTQUERYWF ( STRING szPart icipantName , 

STRING szOrgRole, WFROLE WFRole, 
STRING szBPName, 
DATETIMESTRING szStartDate, 
DATETIMESTRING szEndDate, BOOL bPending, 
BOOL cDialog, BOOL bFileOrMemory, 
LP INT IpiCount, STRING szFileName, 
LPWFSNAPSHOT IpWFSnapShot , 
LPERRCODE IpError) 
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Parameters 



Name 


1 Type 


I Description 


szParticipantName 


STRING 


The participant for which 
the list of workflows is 
returned. 


szOrgRole 


STRING 


The organization role of 
the participant . Only 
workflows that have this 
specific OrgRole are 
selected. If OrgRole is 
specified as NULL then all 
workflows are selected 
regardless of the role. 


WFRoie 


WFROLE 


The workflow role of the 
identity. This field is 
only required if the 
participant is both 
customer and performer or 
is an observer in the 
workflow . 


sz BP Name 


STRING 


The workflows are selected 
only for the specified 
BPName. If BPName is NULL, 
then relevant workflows are 
selected regardless of the 
business process. 


szStartDate, 


DATETIMESTRING 


These dates specify a date 


szBndOate 




range of due dates for 
which the list is 
constructed. If StartDate 
is NULL then the list 
includes all relevant 
workflows . 


bPending 


BOOL 


If Pending is TRUE then the 
list workflows includes 
only those workflows where 
action is pending. The 
workflows which needs to be 
initiated are also 
included. Otherwise it 
includes workflows where 
action is not Dendina. 


cDialog 


BOOL 


If cDialog is TRUE, then a 
dialog box is presented to 
the user to select a 
specific workflow. In this 
case, the list of workflows 
returned by this function 
will be the selected one. 
If cDialog is FALSE, then 
no dialog box is presented 
and all available workflows 
are returned. 
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VOID FAR PASCAL AWSTAVAILABLEBP (STRING SzPart icipantName, 

BOOL cDialog, INT iBPStatus, 
LP INT lpiCount, BOOL bFileOrMemory , 
LPBPINFO lpBPInfo, STRING szFileName, 
LPERRCODE IpError) 



Parameters 



« aluc 


x y p ts 




szParticipantName 


STRING 


The participant for which the 
list of BPs is returned. 


cDialog 


BOOL 


it cuiaj-og is true*, tnen a 
dialog box is presented to the 
user to select a specific BP. 
In this case, the list of BPs 

be the selected one . 

If cDialog is FALSE, then no 

dialog box is presented and 

all aVaiiaUlc Dfro a£Tc 

returned. 




INT 


Indicate the* iBPStatus 
required. ACTIVE_BPS select 
only active BPs. The flag 
INACTIVE selects all BPs in 
the definition database. 


lpiCount 


LP I NT 


The number of BPs returned. 


bF i 1 eO rMemo ry 


BOOL 


Flag to indicate file or 
memory mode of receipt of data 
from the API. 


lpBPInfo 


LPBPINFO 


A pointer to an array of 
BPINFO structures that contain 
the business process name and 
Id. 


szFileName 


STRING 


File name where the API should 
deposit the results of the 
call if the flag bFileOrMemory 
is ITS FILE. 


IpError 


LPERRCODE 


Error code returned by the 
server . 



Return Value 

lpiCount, the number of workflows in the list. 
BPListPtr points to a linked list of BPINFO structures 
that contain the Business Process Name & Id. 



AWSTACTHI STORY 
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bFileOrMemory 


BOOL 


Flag to indicate File or 
Memory mode of receipt of 
data from the API . 


szFileName 


STRING 


File name where the API 
should deposit the results 
of the call if the flag 
bFileOrMemory is ITS FILE. 


lpiCount 


LP I NT 


Returns the count of 
workflows selected. 


lpWFSnapShot 


LPWFSNAPSHOT 


Pointer to a list of 
selected workflows. Each 
workflow includes Business 
Process name & Id, Workflow 
name, Customer, Performer, 
Completion and Reply Dates, 
Status and Form name 


IpError 


LPERRCODE 


Error code returned by the 
server . 



Return Value 

lpiCount, the number of workflows in the list. 
lpWFList points to a list of WFLIST structures. 
The structure returns several dates depending on role of 
the Identity. 



Customer 


Performer 


Completion recruested 


Completion due 


Reply due to Performer 


Reply due to Customer 


Completion due by Performer 


Completion requested by 
Customer 


Reply due by Performer 


Reply due by Customer 



Not all dates are returned, depending on the present 
state of the workflow the relevant dates are returned 



AWSTAVAILABLEBP 

Description 

This function returns a list of BP Names. 

Syntax 
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Description 

This call returns a list of Acts taken in the 
specified business process for a specific workflow. If 
workflow name is NULL f then the history of the entire 
business process, i.e., list of all acts taken of all 
workflows is returned. 

Syntax 

VOID FAR PASCAL AWSTAC THIS TORY (STRING szParticipantName, 

BPTID lBPTid, STRING szWFName, 
LP INT lpiCount, BOOL bFileOrMemory, 
STRING szFileName, 
LPACTSTAKENLIST lpActsList, 
LPERRCODE IpError) 
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This call returns the notification event to the STF 
Processor. If the notification event is "Act Taken", then 
the parameter lpTxId will contain the transaction Id of 
the Act. 

Syntax 

VOID FAR PASCAL AWSTPOLLSTFQUEUE (STRING 

szSTFProcessorName, LPIDEN lpBPTid, 
STRING szWFName, LP INT IpEvent, 
LPIDEN lpTxId, STRING szParticipantName, 
DATETIMESTRING s zCompletionTime, 
DATETIMESTRING szNotif icationTime, 
LPERRCODE IpError) 
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T VD6 


Description 


szSTFProcessorName 


STRING 


STF Processor Name 


ipcr 1 1Q 


T PTnFM 


RPT-M nf -rhp BP 

instance which has 
some notification 

i~ r\ hp cpnf f r> t"hp 

application . 


szwr Name 


O i. I\ ± IN VJ 


instance 


IpEvent 


LP INT 


The Event Id is 
returned here. 


lpTxId • 


LPIDEN 


Txld of the Act if 
Event is "Act 
Taken" 


szParticipantName 


STRING 


The participant's 
name is returned. 


szCompletionTime 


DATETIMESTRING 


Completion date & 
time is returned. 
This is the date 
and time when the 
event was due. For 
example, the 
instance when 
Performer Response 
is due. 


szNot lticat lonTime 


DATETIMESTRING 


Notification date & 
time is returned. 
This is the instant 
when this 
notification was 
placed in the STF 
Queue . 


IpError 


LPERRCODE 


Error code returned 
bv the server. 



Not if icat ion Events 


Event 


Notification Type 


Performer Response 
oast due 


Follow-up 


Performer Completion 
past due 


Follow-up 


Performer Completion 
cominq due 


Reminder 


Customer Response past 
due 


Follow-up 


Act taken 


Act 



Return Value 
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AW S TNUMAVA I L AB LE AC T S 

Description 

Returns number of available acts in the specified 
workflow for the role that the identity has in the 
workflow . 

Syntax 

VOID FAR PASCAL AWSTNUMAVAIL ABLE ACTS (BPTID IBPTid, 

STRING szWFName, WFROLE WFRole, 
STRING szParticipantName, 
LP INT lpiCountPtr, LPERRCODE IpError) 



Parameters 



Name 


1 Type 


Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The 
Id of a previously 
instantiated BP. 


szWFName 


STRING - 


The name of the 
workflow whose status 
is desired 


WFRole 


WFROLE 


The workflow role of 
the identity. 


szParticipantName 


STRING 


The participant for 
which the list of 
available acts is 
returned . 


lpiCountPtr 


LP INT 


Number of acts 
returned in the 
structure 


IpError 


LPERRCODE 


Error code returned 
by the server. 



Return Value 

IpiCount is updated with the number of possible acts the 
Identity can take in the current workflow. 
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AWSTNUMAVAILABLEBP 

Description 

This function returns the number of BPs that 

satisfy a query. 
Syntax 

VOID FAR PASCAL 

AWSTNUMAVAILABLEBP (STRING szParticipantNa 
me, INT iBPStatus, LP INT lpiCount, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szParticipantName 


STRING 


The participant for 
which the list of BPs is 
returned . 


iBPStatus 


INT 


Indicate the iBPStatus 
r equ i r ed . ACT I VE_BP S 
only can be selected or 
all BPs in the 
definition could be 
selected. 


lpiCount 


LPINT 


The number of BPs 
returned. 


IpError 


LPERRCODE 


Error code returned by 
the server. 



Return Value 

lpiCount, the number of workflows in the list. 
AWSTNUMACTHI STORY 

Description 

This call returns the number of Acts taken in the 
specified business process for a specific workflow. If 
workflow Id is NULL, then the history of the entire 
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AWSTGETNUMAP PDATA 
Description 

Number of data fields are returned corresponding to 
the data fields bound to a workflow instance. 

Syntax 

VOID FAR PASCAL AWSTGETNUMAP PDATA (BPTID lBPTid, 

.STRING SzWFTName, WFROLE WFRole, STRING 
szParticipantName, LP INT IpiFieldsPtr, 
LPERRCODE IpError) 



Parameters 



Name 


1 Type 


I Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The Id 
of a previously 
instantiated BP. 


szWFName 


STRING 


The name of the workflow 
from which to retrieve 
bound data. The 
transaction id should be 
null to retrieve 
business process bound 
data . 


WFRole 


WFROLE 


The WFRole of the 
Identity 


szParticipantName 


STRING 


The name of the person 
or identity requesting 
Application Data 
associated with the 
workflow . 


IpiFieldsPtr 


LP INT 


The number of bound data 
field retrieved. 


IpError 


LPERRCODE 


Error code returned by 
the server. 



Return Value 

lpiFields contains the number of fields retrieved. 
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This function returns number of workflows that a 
participant is a member of as a specific Organization 
Role . 



Syntax 

VOID FAR PASCAL AWSTNUMQUERYWF (STRING szParticipantName, 

STRING szOrgRole, STRING szBPName, 
STRING szStartDate, STRING szEndDate, 
BOOL bPending, LP INT lpiCount, 
LPERRCODE IpError) 
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Parameters 



Name 


I Type 


I Description 


szParticipantName 


STRING 


The participant for which the 
list of workflows is 
returned. 


szOrgRole 


STRING 


The organization role of the 
participants. Only workflows 
that have this specific 
OrgRole are selected. If 
OrgRole is specified as NULL 
then all workflows are 
selected regardless of the 
role 


sz BP Name 


STRING 


The workflows are selected 
only for the specified 
BPName. If BPName is NULL, 
then relevant workflows are 
selected regardless of the 
business process. 


szStartDate 


DATETIMESTRING 


StartDate for a^aery list. 


szEndDate 


DATETIMESTRING 


End Date for query list. 
These dates specify a date 
range of due dates for which 
the list is constructed. If 
StartDate is NULL then the 
list includes all relevant 
workflows . 


bPendina 


BOOL 


If Pendino is TRUE then the 
list workflows includes only 
those workflows where action 
is pending. The workflows 
which needs to be initiated 
are also included. .Otherwise 
it includes workflows where 
action is not pendincr. 


lpiCount 


LP INT 


Returns the count of 
workflows selected. 


lpWFSnapShot 


LPWFSNAPSHOT 


Pointer to a list of selected 
workflows. Each workflow 
includes Business Process 
name & Id, Workflow name & 
Id, Customerld, Perf ormerld, 
Completion and Reply Dates, 
Status and form name 


lpError 


LPERRCODE 


Error code returned by the 
server. 



Return Value 

lpiCount, the number of workflows in the list. 
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Customer 


Performer 


Completion reauested 


Completion due 


Reply due to Performer 


Reply due to Customer 


Completion due by 
Performer 


Completion requested by 
Customer 


Reply due by Performer 


Reply due bv Customer 



Not all dates are returned, depending on the present 
state of the workflow the relevant dates are returned. 

AWSTSETCOS 

Description 

This function specifies the Conditions of 
Satisfaction (COS) associated with a workflow of a 
Business Process Instance. The COS is inserted as a 
series of memory blocks. This function requires the 
Business Process context and workflow to be setup before 
execution . 

Syntax 

VOID FAR PASCAL AWSTSETCOS (I DEN lBPTid, STRING szWFName, 

LP MEM lpCOS, LP INT IpiMemBlockSize, ' 
INT iPositionNotify, LP ERRORCODE IpError) 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



140 



PCT/US94/01287 



Parameters 



Name 


1 Type 


I Description 


lBPTid 


BPTID 


Business P rnrp q q 

Transaction Id. The Id 
of a Dreviouslv 
instantiated BP. 


szWFName 


STRING 


The name of the 
workflow. 


lpCOS 


LPMEM 


Pointer to a memory 
chunk which stores COS 
(BLOB) . 


lpiMemBlockSize 


LP INT 


Memory allocated for 
storing COS in bytes. 


iPositionNotif y. 


INT 


This variable iri^nf i f A 
the first COS buffer, 
subsequent COS buffers 
and the last one. It 
should be set to 0 to 
identify first buffer, 1 
to identify subsequent 
buffers . 


1 iDError 


LPERRORCODE 


Error code returned. 



Return Value 



AWSTGETCOS 

Description 

The function gets the COS associated with the 
specified workflow of a Business Process. The COS is 
returned as a series of memory blocks. The memory block 
pointer and the block size allocated is passed to this 
function and the number of bytes actually written in the 
memory block is returned. For the first call, the 
contents of the variable pOffset must be set to zero (0) . 
This indicates the start of the memory block transfers. 
The caller will be notified with a negative value in the 
Offset variable to indicate end of the block transfers. 

Syntax 
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VOID FAR PASCAL AWSTGETCOS (IDEM lBPTid, STRING szWFName, 

LPMEM lpCOS, LP I NT IpiMemBlockSize, LP LONG 
lpOffset, LPERRORCODE IpError) 



Parameters 



Name 


Type Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP . 


szWFName 


STRING 


The name of the workflow. 


ipLUo 


LPMEM 


Pointer to a memory chunk 
which stores COS (BLOB) . 


IpiMemBlockSize 


LP INT 


Memory allocated for 
storincr COS in bytes. 


IpOffset 


LP LONG 


Initially, the caller 
must set this to zero. 
Each block transfer 
changes the value 
contained in this 
variable and the caller 
can only check the value 
returned here. This will 
be negative if end is 
reached . 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Number of bytes actually written. 



Description 

This function returns the workflow transaction id of a 
workflow in a business process instance. 

Syntax 

VOID FAR PASCAL AWSTGETWFTID (IDEN lBPTid, STRING szWFName, 

LPIDEN IpWFTid, LPERRORCODE IpError) 
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Parameters 



Name 


Type 


Description 


lBPTid 


BPTID 


Business Process Transaction 
Id. The Id of a previously 
instantiated BP. 


szWFName 


STRING 


The workflow name for which the 
transaction id is reouired 


lpWFTid 


LPIDEN 


The Transaction Id of the 
workflow is returned. 


lDError 


LPERRCODE 


Error code returned. 



Return Value 



Workflow Definitions API 
AWSDBEGINBP 

Description 

This call creates a new Business Process. The 
Business Process name is specified as a parameter. The 
Business Process name should be unique. If a Business 
Process with the same name is present, the current 
definition is overwritten as a new version. This takes 
place only if there are no active instances of the 
current business processes. The version number. is 
maintained internally by the server. 

The AWSDBeginBP should be the first call when 
defining a business process and no other AWSDBeginBP call 
should be in progress. Every AWSDBeginBP has to be closed 
by a AWSDEndBP call. The AWSDEndBP should be the last 
call and ends the definition of a business process. 

AWSDBeginBP sets up a context for the business 
process and all subsequent calls require this context. 
The AWSDEndBP closes this context . 

Syntax 
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VOID FAR PASCAL AWSDBEGINBP (STRING szBPNaxne, IDEN lBPAdmin, 

LPERRCODE IpError) 



Parameters 



Name 


Typo 1 Description 


szBPName 


STRING 


The Business Process 
name. This name should be 
unique. If a business 
process with the same 
name is present/ the 
current definition is 
over written as a new 
version. There should be 
no active instances of 
the current definition 
for this to occur. 


lBPAdmin 


IDEN 


The Identity of the 
person creating this 
business process. The 
Identity should have the 
rights to create business 
processes . 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSDENDBP 

Description 

Close the currently open business process. A call 
to AWSDENDBP should be preceded by a call to AWSDBEGINBP. 

AWSDENDBP should be the last call when defining a 
business process . Every AWSDBEGINBP has to be closed by a 
AWSDENDBP . The AWSDENDBP should be the last call and ends 
the definition of a business process. The AWSDENDBP 
closes the context set up by AWSDBEGINBP . 
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Note: AWSDENDBP should be called only after a AWSDENDWF 
call has been made. 

Syntax 



VOID FAR PASCAL AWSDENDBP (LPERRCODE IpError) 

Parameters 



Name 


Type 


Description 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSDDELETEBP 

Description 

Deletes a Business Process. The delete is 
successful only if the Business Process has no active 
instances in the activity database. This function is used 
to remove business processes no longer in use. This 
function is called only if the business process is not in 
progress. 

Syntax 

VOID FAR PASCAL AWSDDELETEBP (STRING szBPName, IDEN lBPAdmin, 

LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


szBPName 


STRING 


The name of the business 
process to delete. There 
snouiu De no active 
instances for this 
BPName . 


IBP Admin 


IDEN 


The Identity of the 
person deleting this 
business process. The 
Identity should have the 
rights to delete this 
business processes. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSDSETBPBOUNDDATA 
Description 

Define the list of bound data fields associated with the 
business process. The field name, type, size, attributes 
and initial value, if any, are specified. 

Syntax 

VOID FAR PASCAL AWSDSETBPBOUNDDATA (INT iFields, 

LPBDFIELDSTRUCT IpBDFieldStructPtr , 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


iFields 


INT 


The number of 
fields to attach 
with the business 
process . 


IpBDFieldStructPtr 


LPBDFIELDSTRUCT 


A pointer to an 
array of 
structures 
containing field 
name, type, size, 
attributes and 
initial value, if 
any . 


IpError 


LPERRCODE 


Error code 
returned . 



Return Value 

Error code is returned. 

AWSDBEGINWF 

Description 

Creates a new workflow in a Business Process. The 
workflow name is specified as a parameter. The workflow 
name should be unique. If a workflow with the same name 
is present, then the context for this workflow is set up. 

The AWSDBEGINWF should be the first call when 
defining a workflow and no other AWSDBEGINWF call should 
be in progress. Every AWSDBEGINWF has to be closed by a 
AWSDENDWF call. 

AWSDBEGINWF sets up a context for the workflow and 
all subsequent workflow calls require this context. The 
AWSDENDWF closes this context . 

Syntax 
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VOID FAR PASCAL AWSDBEGIKWF (STRING szWFName, LPERRCODE IpError) 



Name 




Description 


szWFName 


STRING 


The workflow name. This 
name should be uniaue . 


loError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSDENDWF 

Description 

Close the currently open workflow. A call to 
AWSDENDWF should be preceded by a call to AWSDBEGINWF. 

The AWSDENDWF should be the last call when defining 
a workflow. Every AWSDBEGINWF has to be closed by a 
AWSDENDWF call. The AWSDENDWF should be the last call and 
ends the definition of a workflow. The AWSDENDWF closes 
the context set up by AWSDBEGINWF. 

Syntax 



VOID FAR PASCAL AWSDENDWF (LPERRCODE IpError) 



parameters 
Name 


i 

Type 


Description 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSD SET WF INFO 
Description 
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Specify workflow information. The workflow type, 
the organization role for the customer and performer, the 
time offsets for completion and reply are specified. This 
call must be made only after AWSDBEGINWF is called. 

* 

Syntax 

VOID FAR PASCAL AWSDSETWFINFO (WFTYPE WFType, BOOL bCentralWF, 

I DEN lCustomer, IDEN IPerfonner, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


WFType 


WFTYPE 


This specifies the type 
of workflow, i.e., 
Request or Offer or 
Note. 


bCentralWF 


BOOL 


Flag to indicate if this 
workflow is the central 
workflow of the Business 
Process. This flag is 
TRUE if it is the 
central workflow, FALSE 
otherwise . 


lCustomer 


ORGROLEID 


The Organization Role of 
the Customer. 


IPerf ormer 


ORGROLEID 


The Organization Role of 
the Performer. 


IpError | LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 



AWSDSETWFCYCLETIME 

Description 

Set the various cycle times associated with the 
workflow. Depending on the workflow type — Request or 
Offer, the response time for each act of the workflow may 
be specified. The table below enumerates the various 
times that can be stored. 
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Read table below as : 

<OrgRolel> must <Actionl> [after <OrgRolo2> <Action2> ] within 
time <time> 



SI . 


OrcrRolel 


Actionl 


OraRole2 


Action2 


1 


Customer 


Reouest 






2 


Performer 


Respond 


Customer 


Reauest 


3 


Performer 


Complete 


Customer 


Reauest 


4 


Customer 


Respond 


Performer 


Declares 
completion 



SI 


OrgRolel 


Actionl 


OrgRole2 


Action2 


1 


Performer 


Offer 






2 


Customer 


Respond 


Performer 


Offer 


3 


Performer 


Complete 


Customer 


Acrreement 


4 


Customer 


Respond 


Performer 


Declares 
completion 



Note: The call must be made only after function 
AWSD SETWF INFO is called. 

Syntax 



VOID FAR PASCAL AWSDSETCYCLETIME (LPCYCLETIME IpCycleTime, 

LPERRCODE IpError) 
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Parameters 



Name 1 Type 1 Description 


lpCycleTime 


LPCYCLETIME 


Pointer to an array of 
time onsets • uepenajLiiy 
on the workflow tvr>e the 
array elements refer to 
different times are 
listed in the tables 
above. Since the number 
of cycle times for each 
workflow type is known, 
the count is not 
reauired. 


lDError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 



AWSDDI SABLE WF ACT 

Description 

Disable a set of workflow acts for a specific 
workflow role. By default all acts are enabled for a 
workflow. This call facilitates disabling specific acts. 
This call must be made only after a call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDDISABLEWFACT (WFROLE WFRole, INT iCount, 

LP ACT INFO ActPtr, LPERRCODE IpError) 
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Parameters 



Name 


1 Type 


Description 




WFRole 


WFROLE 


The Workflow Role for 
which the acts are to be 
disabled. 




iCount 

•L V* V Wilt 


INT 


The number of acts to 
disable . 




ActPtr 


LPACTINFO 


A pointer to an array of 
structures which 
contains the list of 
acts to disable. The 
number of acts is 
specified by parameter 
nCount 




IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 



AWSDSETACTUSERDEFINEDNAME 

Description 

Set the user-defined description for the workflow 
Acts. The list of acts and the equivalent user-defined 
names are provided. This call must be made only after a 
call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDSETACTUSERDEFINEDNAME (INT iCount, 

LPACTINFO ActPtr, LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


iCount 


INT 


The number of acts for 
which the user-defined 
name has been provided. 


ActPtr 


LPACTINFO 


A pointer to an array of 
structures which 
contains the list of 
acts, i.e., Act Names 
and user-defined Names 
for the acts. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSDSETSTATEUSERDEFINEDNAME 

Description 

Set the User-defined description for the workflow 
states. The list of states and the equivalent user- 
defined names are provided. This call must be made only 
after a call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDSETSTATEUSERDEFINEDNAME < INT iCount, 

LP STATE INFO StatePtr, LPERRCODE IpError) 



Parameters 



Name 


1 Type 


I Description 


iCount 


INT 


The number of states for 
which the user-defined 
name has been provided. 


StatePtr 


LPSTATEINFO 


A pointer to an array of 
structures which 
contains the list of 
states, i.e., State 
Names and user-defined 
names for the states. 


lDError 


LPERRCODE 


Error code returned. 
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Return Value 

Error code is returned. 

AWSDSETACTSCRIPT 
Description 

Set the workflow script for an Act. The act and the 
script text are the parameters to this function. This 
call must be made only after a call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDSETACTSCRIPT (ACT Act, LPMEM lpActScript, BOOL 

bScriptType, LPINT lpiMemBlocfcSize, 
INT iPositionNotify, ERRORCODE SError) 

Parameters 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



154 



PCT/US94/01287 



Name 


Type 1 Description 


Act 


ACT 


Tne type or act, e.g., 
Keauest, Aqxee, etc. 


IpActScript 


LPMEM 


The workflow script 
associated with the 
act. The script is 
executed when the 
corresponding act in 
the workflow is 

cXcCULCU . 


bScriDtTvne 


BOOL 


Script Type is a 
Boolean flag which 
indicates whether the 
script is System 
generated or user 
aenerated. 


IpiMemBlockSize . 


LP INT 


Size of the memory 
block in bytes. 


iPositionNotif y 


INT 


This variable 
identifies the first 
script buffer, 
subsequent buffers and 
the last one. It 
should be set to 0 to 
identify first map 
buffer, 1 to identify 
subsequent map buffers 
and to 2 to indicate 
last buffer. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 



Act script added to the workflow. 
AWSD SET STATE SCRIPT 
Description 

Set the workflow script for a State. The state and the 
script text are the parameters to this function. This 
call must be made only after a call to AWSDBEGINWF. 

Syntax 
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VOID FAR PASCAL AWSDSETACTSCRIPT (STATE State, LPMEM IpStateScript, 

BOOL bScriptType, LP I NT lpiMemBlockSize, 
INT iPositionNotify, LPERRORCODE IpError) 



Parameters 



Name 


Type 


Description 


State 


STATE 


The type of state, e.g., 
Initiate, Negotiation, 
Completing, Satisfied, 
etc . 


IpStateScript 


LPMEM 


The workflow script 
associated with the 
state . The script is 
executed when the 
workflow transits to the 
specified state. 


bScriptType 


BOOL 


Script Type is a Boolean 
flag which indicates 
whether the script is 
System generated or user 
aenerated . 


lpiMemBlockSize 


LP INT 


Size of the memory block 
in bvtes. 


iPositionNotify 


INT 


This variable identifies 
the first script buffer, 
subsequent buffers and 
the last one. It should 
be set to 0 to identify 
first map buffer, 1 to 
identify subsequent map 
buffers and to 2 to 
indicate last buffer. 


loError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

State script added to the workflow. 

AWSDSETWFBOUNDDATAFIELDS 

Description 
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Define the list of bound data fields associated with the 
workflow. The field name, type, size, default attributes 
and initial value, if any, are specified. 

Syntax 

VOID FAR PASCAL AWSDSETWFBOUNDDATAFIELDS (INT iFields, 

LPBDFIELDSTRUCT lpBDFieldStructPtr, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


iFields 


INT 


The number of 
fields to attach 
with the 
workflow . 


lpBDFieldStructPtr 


LPBDFIELDSTRUCT 


A pointer to an 
array of 
structures 
containing field 
name, type, size , 
default 

attributes and 
initial value, if 
any . 


IpError 


LPERRCODE 


Error code 
returned. 



Return Value 

The bound data fields are attached to the workflow. 



Error code is returned. 
AWSDSETWFBDFIELDATTRIBUTE 

Description 

Define the field attributes of bound data fields 
associated with the workflow. The field attributes, Read- 
only, Editable, Hidden and MustFill, may be specified for 
each Act and/or State for a specific workflow role. 
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A call to AWSDSETWFBDF IELDATTRIBUTE must be made 
only after calling AWSDSetWFBoundDataFields . 

Syntax 

VOID FAR PASCAL AWSDSETWFBDF IELDATTRIBUTE (INT iFieldS, 

LPWFMOMENTBDF I ELD STRUCT IpWFMomentBDFieldSt ruct , 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


iFields 


INT 


The number of 






fields to 






attach with 






the workflow. 


IpWFMomentBDFieldSt ruct 


LP WFMOMENTBDF I ELDSTRUCT 


A pointer to 






an array of 






structures 






containing 






field name, 






Act or State, 






Workflow Role 






and 






attributes . 






The 






attributes 






are: Read- 






only, 






Editable, 






Hidden and 






MustFill. 


IpError 


LPERRCODE 


Error code 




returned. 



Return Value 

Error code is returned. 



The attributes of the bound data fields are attached to 
the workflow. 

AWSDSETFORMINFC 
Description 
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Specify workflow form names for Customer, Performer 
and Observer. 

Syntax 

VOID FAR PASCAL AWSDSETFORMINFO (STRING szCusForm, 

STRING szPerForm, STRING szObsForm, 
STRING szlnitForm, LPERRCODE IpError) 



Parameters 



Name | Type 


Description 


szCusForm 


. STRING 


Form name for Customer 
of workflow 


szPerForm 


STRING 


Form name for Performer 
of workflow 


szObsForm 


STRING 


Form name for Observer 
of workflow 


szlnitForm 


STRING 


Init form name of the 
workflow 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

Form names attached to the workflow 
AWSDSETFOLLOWUP 

Description 

Set up follow-up information associated with the 
workflow. The follow-up time offsets for Completion, 
Reply and Reminder are specified. 

A follow-up is sent after the Completion is past 
due. It is sent at the specified time interval after it 
is past due. If the recurring flag for Completion is set, 
then till Completion, follow-up messages are sent at 
every time interval specified. The maximum number of 
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times a follow-up notification is sent could be set using 
this call. 

A follow-up is sent after the Reply is past due. It 
is sent at the specified time interval after it is past 
due. If the recurring flag for Reply is set, then till 
Reply has been sent, follow-up messages are sent at every 
time interval specified. The maximum number of times a 
follow-up notification is sent could be set using this 
call . 

A reminder may be sent before Completion or Reply 
is due. The reminder is sent at a time interval specified 
before the event is due. Reminders may be disabled. A 
reminder is sent only once. 

Syntax 

VOID FAR PASCAL AWSDSETFOLLOWUP (BOOL bPCFUFlag, 

TIMEOFFSET PCFUOffset, BOOL bPCFURecur, 
INT iPCFUCount, BOOL bPRFUFlag, 
TIMEOFFSET PRFUOffset, BOOL bPRFURecur, 
INT iPRFUCount, 

BOOL bCRFUFlag, TIMEOFFSET CRFUOffset, 
BOOL bCRFURecur, INT iCRFUCount, 
TIMEOFFSET PCRemOffset, BOOL bPCRemFlag, 
BOOL bActNotifyFlag, LPERRCODE IpError) 



Parameters 



Name 


1 Type 


1 Description 


bPCFUFlag 


BOOL 


Performer completion 
follow-up flaa. 


PCFUOffset 


TIMEOFFSET 


A follow-up message is 
sent at an interval, 
specified by PCFUOffset, 
after performer 
completion is oast due. 
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bPCFURecur 


BOOL 


If enabled, recurring 
notifications are sent 
at every PCFUOffset 
interval as many as 
PCFUCount times. 


iPCFUCount 


INT 


Number of times the 
follow-up notifications 
should be sent after 
perrormer completion is 
past due. 

ir unis parameter is nui 
specified, and PCFUFlag 
is set, then 
notifications are sent 
till performer 
completes . 


utrt\£ Uf loy 




rerroriuer response 
follow-uo flaa 


PRFUOffset 


TIMEOFFSET 


A follow-up message is 
sent at an interval, 
specified by this 
parameter after 
Performer reply is past 
due . 


bPRFURecur 


BOOL 


If enabled, recurring 
notifications are sent 
at every PRFUOffset 
interval as many as 
PRFUCount times. If 
PRFUFlag is set TRUE and 
PRFUCount is not 
specified, then follow- 
up messages are sent 
until performer replies. 


iPRFUCount 


INT 


Number of times the 
follow-up notifications 
should be sent after 
perrormer completion is 
past due. 

Tf t"hi^ nararnpt* pr i ^ nnt* 

XX V«- ^ ^uipCtlllC LCI X O UUL 

specified, and PRFUFlag 
is set, then 
notifications are sent 
till performer 
completes . 


bCRFUFlag 


BOOL 


Customer response 
follow-up flag 
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CRFUOffset 


TIMEOFFSET 


A follow-up message is 
sent at an interval, 
specified by this 
parameter after customer 
reply is past due. 


bCRFURecur 


BOOL 


If enabled, recurring 
notifications are sent 
at every CRFUOffset 
interval as many as 
CRFUCount times. 


iCRFUCount 


INT 


Number of times the 
follow-up notifications 
should be sent after 
Customer Completion is 
past due. 

If this parameter is not 
specitiect, ana CRFuFiag 
is set, then 
notifications are sent 
till customer replies. 


PCRemOf f set 


TIMEOFFSET 


A reminder is sent at an 
interval PCRemOffset 
before Completion or 
Reolv is due. 


bPCRemFlag 


BOOL 


If this flag is enabled, 
reminders are sent. If 
uibajjieu/ no reminaers 
are sent . 


bActNotifyFlag 


BOOL 


Indicates notification 
status. If set to TRUE, 
notification is- enabled 
else if set to FALSE, it 
is disabled. 


lDError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

Follow-up information attached to the .workflow 
AWSD SET LINK 

Description 

Specify a in coming link to a workflow. For each 
link, the source workflow name, triggering and triggered 
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information is provided. Triggering information 
constitutes whether the link is anchored at an act or 
state and the act/state name. Triggered information 
constitutes whether the link terminates at an act or 
state and the act/state name. 

Note: AWSDSETLINK must be called only after all workflows 
have been created using AWSDBEGINBP . 

Syntax 

VOID FAR PASCAL AWSDSETLINK (STRING SzFWFName, 

BOOL bFActOrState, ACT STATE ID FActState, 
STRING szTWFName, BOOL bTActOrState, 
ACTS TATE ID TActState, LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szFWFName 


STRING 


The source or "from" 
workflow name. The name 
of the workflow where a 
link is anchored. 


bFActOrState 


BOOL 


Flag to indicate if it is 
an Act or State link at 
source . 


FActState 


ACTS TATE ID 


The act or state from 
where the link starts. 


szTWFName 


STRING 


The destination or "to" 
workflow name. The name 
of the workflow to which 
the link is taraeted. 


bTActOrState 


BOOL 


Flag to indicate if it is 
an Act or State link at 
destination. I 
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TActState 


ACTS TATE 


The act or state where 
the link ends. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Link information attached to the workflow 

Error code is returned. 

AWSDPUTMAP 

Description 

Associates a map file with the specified Business 
Process. The map file is inserted as a series of memory 
blocks. This function requires the business process 
context to be setup before execution. 

Syntax 

VOID FAR PASCAL AWSDPUTMAP (LPMEM lpMapMemPtr, LP INT 

lpiMemBlockSize, INT iPositionNotif y, 
LPERRCODE IpError) 



Parameters 



Name 


1 Type 


Description 


lpMapMemPtr 


LPMEM 


Pointer to a memory block 
containinq map. 


lpiMemBlockSize 


LP INT 


Size of the memory block in 
bvtes . 


iPositionNotif y 


INT 


This variable identifies 
the first map buffer, 
subsequent map buffers and 
the last one. It should be 
set to 0 to identify first 
map buffer, 1 to identify 
subsequent map buffers. 


iDError 


LPERRCODE 


Error code returned. 
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Return Value 

Error code is returned. 

AWSDGETMAP 

Description 

Get the map file associated with the specified 
Business Process. The map file is returned as a series 
of memory blocks . The memory block pointer and the block 
size allocated is passed to this function and the number 
of bytes actually written in the memory block is 
returned. Initially, the caller must pass a zero in the 
Offset variable to indicate start of the block transfers. 
The caller will be notified with a negative value in the 
Offset variable to indicate end of the block transfers. 

Syntax 

VOID FAR PASCAL AWSDGETMAP (STRING szBPName, LP MEM 

lpMapMemPtr, LP I NT lpiMemBlockSize, 
LP LONG lpOffset, LPERRCODE IpError) 

Parameters 
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Nam a 

^» Ul ^3 


i x yy 


Descriot ion 


szBPName 


STRING 


Business Process Name with 
which to associate the 
mao . 


lpMapMemPtr 


LPMEM 


Pointer to a memory block 
where man can be returned. 


IpiMemBlockSize 


LPINT 


Size of the memory block 
in bytes . 


lpOf f set 


LPLONG 


Initially, the caller must 
set this to zero. Each 
dxock uranszer cnanges une 
value contained in this 
variable and the caller 
can only check the value 
returned here. This will 
be negative if end is 
reached. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Number of bytes actually written. 
Error code is returned. 
AWSDBP ADD ROLE ASSIGNMENT 

Description 

Sets the Organization Role to Identity mapping at 
the Business Process level. 

Syntax 

void FAR PASCAL AWSDBPADDROLEASSIGNMENT ( IDEN lldentity, 

IDEN lOrgRoleld, LPERRCODE IpError) 

Parameters 
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Name 


Type 


Description 


lldentitv 


IDEN 


Organization Role id. 


lOrgRoleld 


IDEN 


Identity Id to be mapped 
with OraRole 


IpError 


LPERRCODE 


Error code returned. 



Return Value 
AWSDWFADDROLEAS S I GNMENT 

Description 

Sets the Organization Role to Identity mapping at 
the workflow level. 

Syntax 

void FAR PASCAL AWSDWFADDROLEAS SI GNMENT (IDEN lldentity, 

IDEN lOrgRoleld, WFROLE WFRole, 
LPERRCODE IpError) 



Parameters 



Name 


Type | Description 


lldentity 


IDEN 


Identity Id to be mapped 
with OrqRole . 


lOrgRoleld 


IDEN 


Organization Role id. 


WFRole 


WFROLE 


Workflow role of the 
identity . 


loError 


LPERRCODE 


Error code returned. 



Return Value 
AWSDGETBPVERS ION 

Description 

Get the current BP Version for the specified BP 
name. The function returns the Business Process Version. 

Syntax 
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VOID FAR PASCAL AWSDGETBP VERS ION ( IDEN lldentity, STRING 

szBPName, 

LP INT lpiVersion, LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


lldentity 


IDEN 


Identity Id to be mapped with 
OrqRole. 


szBPName 


STRING 


The name of the BP for which 
the version number is 
requested 


lpiVersion 


LP INT 


Pointer to an integer which 
holds the version number of BP 


IpError 


LPERRCODE 


Error code returned. I 



Return Value 



AWSDGETLASTMODIFIEDDATE 
Description 

This function returns the last modified date of the 
Business Process specified. 

Syntax 

VOID FAR PASCAL AWSDGETLASTMODIFIEDDATE (STRING szBPName, 

LPDATETIME pdtLastModif led, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szBPName 


STRING 


The name of the BP for 
which the last modified 
date is requested 


lpdtLastModif ied 


LPDATETIME 


The pointer to the 
DATETIME type which 
holds the last modified 
date of the Business 
Process . 


IpError 


LPERRCODE 


Error code returned. 



Return Value 
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AWSDSETBPNOTIFICATION 

Description 

The notification string for the event is set with 
respect to the current BP context . 

Syntax 

void FAR PASCAL 

AWSDSETBPNOTIFICATION (EVENT Not if icat ionE 
vent, STRING szNotif icationString, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


Not if icationEvent 


EVENT 


This parameter 
notifies the event 


szNot if icationString 


STRING 


The notification 
strinq . 


IpError 


LPERRCODE 


Error code returned. 



Notification Events 



Event 


Notification 
Type 


Performer Response past due 


Follow-up 


Performer Completion past due 


Follow-up 


Performer Completion comino due 


Reminder 


Customer Response past due 


Follow-up 


Act taken 


Act 



Return Value 
AWSDSETWFNOTI F I CATION 

Description 

The notification string for the event is set with 
respect to the current WF context . 

Syntax 
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void FAR PASCAL 



AWSDSETWFNOTIFICATION (EVENT Not if icat ionE 
vent, STRING szNotif icat ionSt ring, 
LPERRCODE IpError) 



Parameters 


Name 


Tvpe 


Description 


Not if icationEvent 


EVENT 


This parameter 
notifies the event 


s zNot i f i ca t ionSt ring 


STRING 


The notification 
string . 


IpError 


LPERRCODE 


Error code returned. 


Notification Events 


Event 


Notification Type 


Performer Response past due 


Follow-up 


Performer Completion past due 


FoIIow-ud 


Performer Completion coming due 


Reminder 


Customer Response past 


due 


Follow-up 


Act taken 


Act 


Return Value 






AWSDSETCOS 







Description 

This function specifies COS associated with a 
workflow of a Business Process. The COS is inserted as a 
series of memory blocks. This function requires the 
Business Process context and workflow to be setup before 
execution , 

Syntax 

VOID FAR PASCAL AWSDSETCOS (LPMEM lpCOS, 

LP INT IpiMemBlockSize, 

INT iPositionNotify, LPERRORCODE IpError) 
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Parameters 



Name 


Type | Description 


lpCOS 


LPMEM 


Pointer to a memory 
chunk which stores COS 
(BLOB) . 


lpiMemBlockSize 


LP INT 


Memory allocated for 
storing COS in bvtes . 


iPositionNotify 


INT 


This variable 

lGcilwlIlcS lI16 IllSt 

COS buffer, subsequent 
COS buffers and the 
last one. It should be 
set to 0 to identify 
first buffer, 1 to 
identify subsequent 
buffers and to 2 to 
indicate last buffer. 


lDError 


LPERRORCODE 


Error code returned. 



Return Value 



AWSDGETCOS 

Description 

The function gets the COS associated with the 
specified workflow of a Business Process. The COS is 
returned as a series of memory blocks . The memory block 
pointer and the block size allocated is passed to this 
function and the number of bytes actually written in the 
memory block is returned. For the first call, the 
contents of the variable pOffset must be set to zero (0) . 
This indicates the start of the memory block transfers. 
The caller will be notified with a negative value in the 
Offset variable to indicate end of the block transfers. 

Syntax 

VOID FAR PASCAL AWSDGETCOS (STRING szBPName, 

STRING szWFName, LPMEM lpCOS, 
LP INT lpiMemBlockSize, LP LONG lpOffset, 
LPERRORCODE IpError) 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



4/6 



PCT/US94/01287 




SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



5/6 



PCT/US94/01287 



TRANSACTION 
MANAGER 

1 
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Parameters 



Name 


Type 


Description 


bGroupOr Ident i t y 


BOOL 


Flag to indicate if 
Assignee is a laentity 
or a Group. If 
GroupOr Identity is 
TRUE, then Assignee 
contains a Groupld, 
otnerwise it is 


lAssignee 


IDEN 


The id of the Identity 
or Group being 
inouired. 


lpiCount 


T T5 T VT 1 
LP INT 


Dn i nt - or* t- r-\ a rnnntpr 

ruintci L.O a uuunuci . 

The number of 
Organization Roles an 
Identity/Group is 
assianed. 


lAuthorize Identity 


IDEN 


The Identity of the 
person Inquiring. The 
person must have the 
authority to Inauire. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 



AWSNGETNUMIDENASS IGNEELIST 

Description 

Determine the number of Identities that are 
assigned to a specific Organization Role. 

Syntax 

VOID FAR PASCAL 

AWSNGETIDENASS IGNEELIST ( IDEN lOrgRoleld 

, LP INT lpiCount, 

IDEN lAuthorizeldentity, 

LPERRCODE IpError) 
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assigned the specific Organization Role. Follow-up 
flags to enable/disable Reminders and Follow-up 
messages may be specified here. If an assignment is 
already present then the new Follow-up flags are 
assigned. 

Syntax 

VOID FAR PASCAL 

AWSNADDROLEASS IGNMENT (BOOL bGroupOrlden 

tity, IDEN lAssigneeld, 

IDEN lOrgRoleld, 

IDEN lAuthorizeldentity, 

LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


bGroupOr Identity 


BOOL 


Flag to indicate if 
Assignee is an identity 
or a Group. If 
GroupOr Identity is 
TRUE, then Assignee 
contains a Groupld, 
otherwise it is an 
Identity. 


lAssignee 


IDEN/IDEN 


The id of the Identity 
or Group being assigned 
the Organization Role. 
If a Group is being 
assigned, then all 
members of the group 
inherit the Role 


lOrgRoleld 


ORGROLEID 


The Organization Role 
the Identity or Group 
will be assigned. 


lAuthorize Identity 


IDEN 


The Identity of the 
person assigning role. 
The person must have 
the authority to make 
this assianment. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

Identity/Group assigned Organization Role. 
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Parameters 



Name 


Type 


Description 


lOrgRoleld 


ORGROLEID 


The Organization Role 
for which list of 
Assignees is being 
returned. 


lpiCountPtr 


LP INT 


Pointer to a counter. 
The number of 
Assignees ( Identities 
or Groups) associated 
witn tne organization 
Role OrqRole 


lAuthorizeldentity 


IDEN 


The Identity of the 
person requesting the 
list. The person must 
have the authority to 
inauire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 



Schedule API 

The following is a description of the functions 
performed by the components of the Schedule API for 
implementation of the Schedule API. 
AWSSPUTBPSCHEDULE 

Description 

The schedule information associated with a 
business process is stored in the server. The time 
when the business process needs to be initiated and 
recurrence information are stored. 

Syntax 

VOID FAR PASCAL AWSSPUTBPSCHEDULE ( STRING szBPName, 

DATETIMET UnitTime, 
DATE TIMET IRecurPeriod, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Name 


Type 


Description 


lOrgRoleld 


IDEN 


The Organization Role 

■Fny whiph li^t" of 

Assignees is being 
returned . 


lpiCountPtr 


LP INT 


Pointer to a counter. 
The number of Assignees 
(iaenuiuj.es or ijroupsj 
associated with the 
Organization Role 
OrcfRole 


lAuthorize Identity 


IDEN 


The Identity of the 
person requesting the 
list. The person must 
have the authority to 
inauire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 



AWSNGETNUMGROUPASSIGNEELIST 

Description 

Determine the list of Identities and Groups that 
are assigned to a specific Organization Role. This 
function returns a list of Identities and Group and 
their names. 

Syntax 

VOID FAR PASCAL 

AWSNGETNUMGROUPASSIGNEELIST (IDEN lOrgRo 
leld, LP INT lpiCount, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



97 n in a 

A* ClIU V3 


1 Type 


1 A S 0* 4 ^ m ^ 

| Uc3C!ipi>iOn 


szOrgRoleName 


STRING 


The Organization Role 
name to add to the 
server. The name should 
be uniaue. 


lpOrgRoleld 


LPIDEN 


The OrgRoleld is 
returned on successful 

aQQlLlun ox urgaiiizaLion 
role name to the server. 


lAuthorize Identity 


IDEN 


Identity of the person 
adding the name to the 
server. The Identity 
must be authorized to 
add names . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

The Organization Role Id, OrgRoleld is returned by the 
function . 



AWSNINQUIREORGROLE 
Description 

Inquire if a specified Organization Role is present 
in the server database. If present, the Organization Role 
Id is returned. 

Syntax 

VOID FAR PASCAL AWSNINQUIREORGROLE (STRING szOrgRoleName, 

LPIDEN lpOrgRoleld, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Name 


Type 


Description 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
deleted from Transaction 
database . 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSSuspendBP 

This call suspends the execution of specified 
business process instance by changing the status of BP 
transaction instance class (TxBPInstance) . No 
transactions can take place on the business process 
till it is restarted again by a call to AWSRestartBP . 

Syntax 

void FAR PASCAL AWSSuspendBP ( IpszBPTId ) 



Parameters 



Name 


Type 


Description 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
suspended. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSResumeBP 
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Parameters 



Name 


Tvpe 


Description 


IGroupMemberld 


IDEN 


The Identity of the 
person being 
assigned to the 
Group, identified 
by Groupld. 


lpiCount 


LP INT 


Pointer to a 
counter. The number 
of groups 
GroupMember is a 
member of . This 
value is returned. 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory mode 
of receipt of data 
from the API . 


lpGroupInf oArray 


LPGENERALINFO 


The list of groups 
GroupMember is a 
member of. For each 
group, the Group Id 
and Group Name are 
returned. A pointer 
to an array of 
Group Ids and Group 
Names is returned 


szFileName 


STRING 


File name where the 
API should deposit 
the results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of the 
person Inquiring. 
The person must 
have the authority 
to Inauire. 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

The count of groups and a list of Groupld and 
GroupName returned . 



AWSNGETGROUPMEMBERS 
Description 
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Parameters 



Name 


Type 


Description 


IGroupMemberld 


IDEN 


The Identity of the 
person being 
assigned to the 
Group, identified 
bv Grovpld. 


lpiCount 


LP INT 


Pointer to a 
counter. The number 
of groups 
GroupMember is a 
member of. This 
value is returned. 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory mode 
of receipt of data 
from the API . 


lpGroupInf oArray 


LPGENERALINFO 


The list of groups 
GroupMember is a 
member of. For each 
group, the Group Id 
and Group Name are 
returned. A pointer 
to an array of 
Group Ids and Group 
Names is returned 


szFileName 


STRING 


File name where the 
API should deposit 
the results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person Inquiring. 
The person must 
have the authority 
to Inauire. 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

The count of groups is returned. 



AWSNGETNUMGROUP MEMBERS 

Description 

Get the number of all members in a group. 

Syntax 
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Parameters 



Name 


Type 


Description 


lOrgRoleld 


IDEN 


The Organization Role 
for which list of 
Assignees is being 
returned. 


lpiCountPtr 


LPINT 


Pointer to a counter. 

Th^ numhpi- of 

X 11C 11 U1VUJC L 

Assignees ( Identities 
or Groups) associated 
with the Organization 
Role OraRole 


bFileOrMemory 


BOOL 


Flag to indicate File 
or Memory mode of 
receipt of data from 
the API 


lpldenlnf oArray 


LP ASSIGNEE 


List of identities who 
are associated with a 
specific organization 
role. The bNotify flag 

acQnri 3t*pH with fhp 

Identity is also 
returned. A pointer to 
a list is returned. 


szFileName 


STRING 


File name where the 

results of the call if 
the flag bFileOrMemory 
is ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of the 
person requesting the 
list. The person must 
have the authority to 
inauire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

List and Count returned. 



AWSNGETGROUPASS IGNEELI ST 

Description 

Determine the list of Identities and Groups that 
are assigned to a specific Organization Role. This 
function returns a list of Identities and Group and 
their names . 

Syntax 
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Return Value 

List and Count returned. 

AWSNGETIDENAS S I GNEELIST 

Description 

Determine the list of Identities that are 
assigned to a specific Organization Role. This 
function returns a list of Identities and their names. 

Syntax 

VOID FAR PASCAL 

AWSNGETIDENASSIGNEELIST ( IDEN lOrgRoleld 

, LP INT lpiCount, BOOL bFileOrMemory , 

LPASSIGNEE lpldenlnf oArray , 

STRING szFileName, 

IDEN lAuthorizeldentity, 

LPERRCODE IpError) 
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Parameters 



Name 


Tvpe 


Description 


hGrounOrldentitv 


BOOL 


Flag to indicate 
if Assignee is a 
Identity or a 
Group. If 
GrovpOr Identity is 
TRUE, then 
Assignee contains 
a Groupid, 
otherwise it is 


lAs s ianee 


IDEN 


The id of the 
Identity or Group 
beincr inauired. 


IpiCount 


LP INT 


Pointer to a 
counter. The 
number of 

Organization Roles 
an Identity/Group 
is assianed. 


* bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory 
mode of receipt of 
data from the API. 


lpOrgRolelnf oArray 


LPGENERALINFO 


The list of 
Organization Roles 
Assignee is 
assigned to. For 

aaph Pnlp f hp 
^ a ^ii i\ v^/ x. ^ , Liic 

OrgRole, Follow-up 
flags and. the 
description are 
returned. A 
pointer to a list 
of OrgRoles and 
description is 
returned . 


szFileName 


STRING 


File name where 
the API should 
deposit the 
results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of 
the person 
Inquiring. The 
person must have 
the authority to 
Inauire . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 
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Parameters 



Name 


Type 


Description 


lGroupId 


IDEN 


The Groupld of 
the group from 
which to retrieve 
list of members . 


IpiCount 


LP INT 


Pointer to 
nCount, the 
number of members 
in the Group. 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory 
mode of receipt 
of data from the 
API . 


lpGenerallnfoArray 


LPGENERAL INFO 


A list of members 
in the group is 
returned. The 
list contains the 
Identityld and 
IdentityName of 
each member. 
IpGeneralln foArra 
y is a pointer to 
an array. 


szFileName 


STRING 


File name where 
the API should 
deposit the 
results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity or 
the person 
inquiring. The 
person must have 
the authority to 
inauire . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

List of members returned. 



AWSNADDROLEAS S IGNMENT 

Description 

Assign an Identity or a Group to an Organization 
Role. The Identity or all members of the group are 
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Get the list of all members in a group. The 
Identity of each member in a group is returned. The 
IdentityName is also returned. 

Syntax 



void FAR PASCAL AWSNGETGROUP MEMBERS ( IDEN lGroupId, 

LP INT lpiCount, BOOL bFileOrMemory, 
LPGENERALINFO lpMemberlnf oArray , 
• STRING szFileName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lGroupId 


IDEN 


The Groupld of the 

iT T" f"\ 1 1 y OTTI uhl C H 1" O 

remove GroupMember . 


xbroupncnujcx iu 


THEN 


The Identity of the 
person being removed 
from the Group, 
identified by Groupld. 


lAut hor i ze I dent it y 


IDEN 


The Identity of the 
person deleting. The 
person must have the 
authority to delete. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

The Identity is removed from the group. 



AWSNGETGROUPLIST 

Description 

Determine the list of groups an Identity is a 
member of. This function returns a list and a count. 

Syntax 

VOID FAR PASCAL AWSNGETGROUPLIST ( IDEN lGroupMemberld, 

LP INT lpiCount, BOOL bFileOrMemory , 
LPGENERALINFO IpGroupInf oArray , 
STRING szFileName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Deletes the Observer Organization Role(s) at the 
workflow level. 

Syntax 

VOID FAR PASCAL AWSDWFDELETEOBSROLE (IDEN lOrgRoleld, 



LPERRCODE IpError) 
Parameters 



Name 


Type 


Description 


lOrqRoleld 


IDEN 


Orqanization Role id. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Karnes and Routings API 
AWSNADDORGROLE 



Description 

Add a new Organization Role name to the server. 
This name should be unique. The Organization Role Id is 
returned. 

Syntax 

VOID FAR PASCAL AWSNADDORGROLE (STRING szOrgRoleName, 

LP IDEN lpOrgRoleld, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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